Token API | Procurize.AI#

Buat, kelola, dan gunakan token API untuk akses programatik yang aman ke ruang kerja Procurize.AI Anda.

Berlaku untuk: Dashboard Procurize.AI → Pengaturan → Token
Tersedia pada: paket Business & Enterprise
Peran yang diperlukan: Manajer Keamanan, Editor, Admin, atau Pemelihara

Gambaran Umum#

Token API memungkinkan akses programatik yang aman ke platform Procurize.AI. Anda dapat menggunakan token untuk mengintegrasikan Procurize.AI dengan sistem internal Anda, mengotomatisasi alur kerja, atau membangun aplikasi khusus di atas platform.

Karakteristik utama:

Token mewarisi semua izin dari pengguna yang membuatnya
Token bersifat bercakupan organisasi – tidak perlu menyebutkan org dalam panggilan API
Token tidak terbatas dapat dibuat
Token dapat memiliki tanggal kedaluwarsa atau diatur agar tidak pernah kedaluwarsa
Token dapat dinonaktifkan dan kemudian diaktifkan kembali sesuai kebutuhan

🔒 Catatan keamanan: Procurize.AI tidak menyimpan nilai token – hanya hash-nya. Anda harus menyalin dan menyimpan token segera setelah dibuat. Token tidak akan ditampilkan lagi.

Mengakses Panel Manajemen Token#

Buka halaman Dashboard → Token API.
Panel manajemen token menampilkan token pribadi Anda yang terkait dengan organisasi saat ini.

Halaman token API

Izin yang diperlukan: Hanya pengguna dengan peran Manajer Keamanan, Editor, Admin, atau Pemelihara yang dapat mengakses panel ini. Untuk definisi peran secara detail, lihat Gambaran Izin .

Membuat Token Baru#

Masukkan Nama untuk mengidentifikasi tujuan token.
Pilih periode kedaluwarsa:
- 1 bulan
- 3 bulan
- 1 tahun
- Tidak ada kedaluwarsa (validitas tak terbatas)
Klik “Buat”.

Penting – Salin Token Segera#

Setelah pembuatan, nilai token ditampilkan sekali – salin dan simpan dengan aman (misalnya, di pengelola kata sandi atau variabel lingkungan).

Token API baru

⚠️ Anda tidak akan dapat melihat nilai token lagi. Procurize.AI hanya menyimpan hash yang aman untuk verifikasi. Jika Anda kehilangan token, Anda harus mencabutnya dan membuat token baru.

Mengelola Token yang Ada#

Panel Token menampilkan daftar semua token yang dibuat beserta:

Nama
Akhiran
Tanggal pembuatan
Tanggal kedaluwarsa (atau “-”)
Status: Aktif atau Tidak Aktif

Menonaktifkan / Mengaktifkan Kembali Token#

Nonaktifkan – menonaktifkan token sementara. Anda dapat mengaktifkannya kembali nanti bila diperlukan.
Aktifkan kembali – mengembalikan token yang sebelumnya dinonaktifkan ke status aktif.

💡 Penonaktifan berguna untuk menangguhkan integrasi sementara tanpa menghapus token.

Mencabut Token#

Cabut – menghapus token secara permanen. Tindakan ini tidak dapat dibatalkan.
Jika Anda kehilangan token, cabut segera dan buat token baru.

Menggunakan Token API#

URL Dasar & Autentikasi#

Parameter	Nilai
URL Dasar	`https://api.procurize.com`
Metode autentikasi	API key via header
Header	`X-API-Key: <YOUR_API_TOKEN>`

Contoh Permintaan (cURL)#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"

🧠 Tidak perlu ID organisasi – token terikat pada organisasi Anda, sehingga API secara otomatis menentukan konteks.

Aturan Keamanan & Penggunaan Penting#

Aturan	Penjelasan
Izin token	Token memiliki izin yang persis sama dengan pengguna yang membuatnya. Jika peran pengguna berubah, izin token akan diperbarui secara otomatis.
Pengikatan organisasi	Token terikat pada organisasi pembuatnya. Anda tidak dapat menggunakan token di beberapa organisasi.
Visibilitas token	Nilai token ditampilkan hanya sekali. Simpan segera. Procurize.AI hanya menyimpan hash.
Token kedaluwarsa	Token yang kedaluwarsa secara otomatis dinonaktifkan dan tidak dapat digunakan. Buat token baru jika diperlukan.

Pemecahan Masalah#

Masalah	Solusi
Kesalahan “Invalid API key”	Periksa bahwa token telah disalin dengan benar (tanpa spasi tambahan). Pastikan token masih aktif dan belum kedaluwarsa.
Token tidak berfungsi setelah perubahan peran	Izin token diperbarui agar sesuai dengan peran pengguna saat ini. Jika pengguna kehilangan izin, token juga kehilangan izin tersebut.
Token hilang	Cabut token yang hilang dan buat token baru.
Pembatasan laju	Batas laju API berlaku berdasarkan paket Anda. Periksa header `X-RateLimit-*` dalam respons.

Topik Terkait#

Gambaran Izin – definisi peran secara detail
Paket Harga – paket mana yang termasuk akses API
Referensi REST API – dokumentasi endpoint secara detail