Token API | Procurize.AI#

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

Berlaku untuk: Procurize.AI Dashboard → Pengaturan → Token
Tersedia pada: Paket Business & Enterprise
Peran yang diperlukan: Admin atau Maintainer

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, mengotomatiskan alur kerja, atau membangun aplikasi khusus di atas platform.

Karakteristik utama:

• Token mewarisi semua izin pengguna yang membuatnya
• Token bersifat berkaitan dengan organisasi – tidak perlu menyebutkan org dalam panggilan API
• Jumlah token tidak terbatas dapat dibuat
• Token dapat memiliki tanggal kedaluwarsa atau diset agar tidak pernah kedaluwarsa
• Token dapat dinonaktifkan dan kemudian diaktifkan kembali bila diperlukan

🔒 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#

1. Buka Dashboard → Pengaturan → tab Token.
2. Panel manajemen token menampilkan token pribadi Anda yang terkait dengan organisasi saat ini.

{title=“Panel token API” alt=“Panel token API”}

Izin yang diperlukan: Hanya pengguna dengan peran Admin atau Maintainer yang dapat mengakses panel ini. Untuk definisi peran secara detail, lihat Gambaran Umum Izin .

Membuat Token Baru#

1. Masukkan Nama untuk mengidentifikasi tujuan token.

2. Pilih periode kedaluwarsa:

   • 1 bulan
   • 3 bulan
   • 1 tahun
   • Tanpa kedaluwarsa (validitas tak terbatas)

3. Klik “Buat”.

Penting – Salin Token Segera#

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

{title=“Token API baru” alt=“Token API baru”}

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

Mengelola Token yang Ada#

Panel Token menampilkan daftar semua token yang sudah 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#

Contoh Permintaan (cURL)#

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

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

Aturan Keamanan & Penggunaan Penting#

Pemecahan Masalah#

Topik Terkait#

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