Token API | Procurize.AI#
Hasilkan, urus, dan gunakan token API untuk akses programatik selamat ke ruang kerja Procurize.AI anda.
Berkuat kuasa pada: Dashboard Procurize.AI → Tetapan → Token
Tersedia pada: Pelan Business & Enterprise
Peranan diperlukan: Admin atau Maintainer
Gambaran Keseluruhan#
Token API membolehkan akses programatik yang selamat ke platform Procurize.AI. Anda boleh menggunakan token untuk mengintegrasikan Procurize.AI dengan sistem dalaman anda, mengautomasi alur kerja, atau membina aplikasi khusus di atas platform ini.
Ciri‑ciri utama:
- Token mewarisi semua kebenaran pengguna yang menciptanya
- Token berskala organisasi – tidak perlu menyebut
orgdalam panggilan API - Token tidak terhad boleh dihasilkan
- Token boleh mempunyai tarikh luput atau ditetapkan tidak pernah luput
- Token boleh dinyahaktifkan dan kemudian diaktifkan semula mengikut keperluan
🔒 Nota keselamatan: Procurize.AI tidak menyimpan nilai token – hanya hash‑nya. Anda mesti menyalin dan menyimpan token serta‑merta selepas penjanaan. Ia tidak akan ditunjukkan lagi.
Mengakses Panel Pengurusan Token#
- Navigasi ke Dashboard → Tetapan → tab Token.
- Panel pengurusan token memaparkan token peribadi anda yang berkaitan dengan organisasi semasa.
Kebenaran diperlukan: Hanya pengguna dengan peranan Admin atau Maintainer yang boleh mengakses panel ini. Untuk definisi peranan terperinci, lihat Gambaran Keseluruhan Kebenaran .
Menjana Token Baru#
Masukkan Nama untuk mengenal pasti tujuan token.
Pilih tempoh luput:
- 1 bulan
- 3 bulan
- 1 tahun
- Tiada luput (validiti tidak terhad)
Klik “Hasilkan”.
Penting – Salin Token Segera#
Selepas penjanaan, nilai token dipaparkan sekali sahaja – salin ia dan simpan dengan selamat (contoh: dalam pengurus kata laluan atau pembolehubah persekitaran).
⚠️ Anda tidak akan dapat melihat nilai token lagi. Procurize.AI hanya menyimpan hash selamat untuk pengesahan. Jika anda kehilangan token, anda mesti menarik baliknya dan menjana token baru.
Mengurus Token Sedia Ada#
Panel Token memaparkan senarai semua token yang dihasilkan bersama:
- Nama
- Akhiran
- Tarikh ciptaan
- Tarikh luput (atau “-”)
- Status: Aktif atau Tidak Aktif
Menyahaktifkan / Mengaktifkan Semula Token#
- Menyahaktifkan – sementara menonaktifkan token. Anda boleh mengaktifkannya semula bila diperlukan.
- Mengaktifkan semula – mengembalikan token yang telah dinyahaktifkan ke status aktif.
💡 Penyahaktifan berguna untuk menangguhkan integrasi sementara tanpa memadam token.
Menarik Balik Token#
- Tarik balik – memadam token secara kekal. Tindakan ini tidak boleh dipulihkan.
- Jika anda kehilangan token, tarik baliknya serta‑merta dan hasilkan token baru.
Menggunakan Token API#
URL Asas & Pengesahan#
| Parameter | Nilai |
|---|---|
| URL Asas | https://api.procurize.com |
| Kaedah pengesahan | Kunci API melalui 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 diperlukan ID organisasi – token terikat kepada organisasi anda, jadi API secara automatik menentukan konteks.
Peraturan Keselamatan & Penggunaan Penting#
| Peraturan | Penjelasan |
|---|---|
| Kebenaran token | Token mempunyai kebenaran yang sama seperti pengguna yang menciptanya. Jika peranan pengguna berubah, kebenaran token akan dikemas kini secara automatik. |
| Pengikatan organisasi | Token terikat kepada organisasi pencipta. Anda tidak boleh menggunakan token yang sama merentasi pelbagai organisasi. |
| Keterlihatan token | Nilai token hanya ditunjukkan sekali. Simpan ia serta‑merta. Procurize.AI hanya menyimpan hash. |
| Token luput | Token yang telah luput secara automatik dinyahaktifkan dan tidak boleh digunakan. Hasilkan token baru jika diperlukan. |
Penyelesaian Masalah#
| Isu | Penyelesaian |
|---|---|
| Ralat “Invalid API key” | Pastikan token disalin dengan betul (tiada ruang tambahan). Pastikan token masih aktif dan belum luput. |
| Token tidak berfungsi selepas perubahan peranan | Kebenaran token dikemas kini mengikut peranan semasa pengguna. Jika pengguna kehilangan kebenaran, token juga akan kehilangan kebenaran tersebut. |
| Token hilang | Tarik balik token yang hilang dan hasilkan token baru. |
| Had kadar | Had kadar API bergantung pada pelan anda. Periksa header X-RateLimit-* dalam respons. |
Topik Berkaitan#
- Gambaran Keseluruhan Kebenaran – definisi peranan terperinci
- Pelan Harga – pelan mana yang termasuk akses API
- Rujukan REST API – dokumentasi terperinci tentang titik akhir