Token API | Procurize.AI#
Hasilkan, urus, dan gunakan token API untuk akses programatik selamat ke ruang kerja Procurize.AI anda.
Berkenaan dengan: Dashboard Procurize.AI → Tetapan → Token
Tersedia pada: Pelan Business & Enterprise
Peranan diperlukan: Pengurus Keselamatan, Penyunting, Pentadbir atau Penjaga
Gambaran Keseluruhan#
Token API membolehkan akses programatik selamat ke platform Procurize.AI. Anda boleh menggunakan token untuk mengintegrasikan Procurize.AI dengan sistem dalaman anda, mengautomasikan aliran kerja, atau membina aplikasi tersuai di atas platform.
Ciri-ciri utama:
- Token mewarisi semua kebenaran pengguna yang menciptanya
- Token berskala organisasi – tidak perlu menyatakan
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 hashnya. Anda mesti menyalin dan menyimpan token serta-merta selepas dijana. Ia tidak akan ditunjukkan lagi.
Mengakses Panel Pengurusan Token#
- Navigasi ke halaman Dashboard → Token API.
- Panel pengurusan token memaparkan token peribadi anda yang berkaitan dengan organisasi semasa.
Kebenaran diperlukan: Hanya pengguna dengan peranan Pengurus Keselamatan, Penyunting, Pentadbir atau Penjaga 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 (kesahihan tidak terhad)
Klik “Jana”.
Penting – Salin Token Segera#
Selepas dijana, nilai token dipaparkan sekali sahaja – salin 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 mencabutnya dan menjana token baru.
Mengurus Token Sedia Ada#
Panel Token memaparkan senarai semua token yang dijana dengan:
- Nama
- Akhiran
- Tarikh ciptaan
- Tarikh luput (atau “-”)
- Status: Aktif atau Tidak Aktif
Menyahaktifkan / Mengaktifkan Semula Token#
- Nyahaktifkan – menyahaktifkan token sementara. Anda boleh mengaktifkannya semula kemudian bila diperlukan.
- Aktifkan semula – mengembalikan token yang sebelumnya dinyahaktifkan ke status aktif.
💡 Penyahaktifan berguna untuk menangguhkan integrasi sementara tanpa memadam token.
Mencabut Token#
- Cabut – memadam token secara kekal. Tindakan ini tidak dapat dipulihkan.
- Jika anda kehilangan token, cabutnya serta-merta dan jana token baru.
Menggunakan Token API#
URL Asas & Pengesahan#
| Parameter | Nilai |
|---|---|
| Base URL | https://api.procurize.com |
| Authentication method | 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"
🧠 Tiada ID organisasi diperlukan – token terikat kepada organisasi anda, jadi API menyelesaikan konteks secara automatik.
Peraturan Keselamatan & Penggunaan Penting#
| Peraturan | Penjelasan |
|---|---|
| Kebenaran token | Token mempunyai kebenaran yang sama tepat dengan pengguna yang menciptanya. Jika peranan pengguna berubah, kebenaran token akan dikemas kini mengikutnya. |
| Pengikatan organisasi | Token diikat kepada organisasi pencipta. Anda tidak boleh menggunakan token merentasi pelbagai organisasi. |
| Keterlihatan token | Nilai token ditunjukkan hanya sekali. Simpan segera. Procurize.AI hanya menyimpan hash. |
| Token luput | Token yang luput secara automatik dinyahaktifkan dan tidak boleh digunakan. Jana token baru jika diperlukan. |
Penyelesaian Masalah#
| Isu | Penyelesaian |
|---|---|
| Ralat “Kunci API tidak sah” | Pastikan token disalin dengan betul (tiada ruang tambahan). Sahkan token masih aktif dan tidak luput. |
| Token tidak berfungsi selepas perubahan peranan | Kebenaran token dikemas kini untuk sepadan dengan peranan semasa pengguna. Jika pengguna kehilangan kebenaran, token juga kehilangan kebenaran tersebut. |
| Token hilang | Cabut token yang hilang dan jana token baru. |
| Had kadar | Had kadar API dikenakan berdasarkan 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 API REST – dokumentasi titik akhir terperinci