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

![Panel token API](/images/docs/api-tokens-panel.png){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](/what-user-permissions-does-procurize-have/) .

## 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).

![Token API baru](/images/docs/new-api-token.png){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

| Parameter | Nilai |
|-----------|-------|
| **URL Dasar** | `https://api.procurize.com` |
| **Metode autentikasi** | Kunci API lewat header |
| **Header** | `X-API-Key: <TOKEN_API_ANDA>` |

### Contoh Permintaan (cURL)

```bash
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

| Aturan | Penjelasan |
|--------|------------|
| **Izin token** | Token memiliki izin yang persis sama dengan pengguna yang membuatnya. Jika peran pengguna berubah, izin token juga diperbarui. |
| **Keterikatan organisasi** | Token terikat pada organisasi pembuatnya. Anda tidak dapat menggunakan token lintas organisasi. |
| **Visibilitas token** | Nilai token hanya ditampilkan **sekali**. Simpan segera. Procurize.AI hanya menyimpan hash. |
| **Token kedaluwarsa** | Token yang kedaluwarsa secara otomatis dinonaktifkan dan tidak dapat digunakan. Buat token baru bila diperlukan. |

## Pemecahan Masalah

| Masalah | Solusi |
|---------|--------|
| **Kesalahan "Invalid API key"** | Periksa bahwa token 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 tingkat** | Batas laju API berlaku sesuai paket Anda. Periksa header `X-RateLimit-*` dalam respons. |

## Topik Terkait

- [Gambaran Umum Izin](/what-user-permissions-does-procurize-have/) – definisi peran secara detail  
- [Paket Harga](https://www.procurize.ai/pricing/) – paket mana yang menyertakan akses API  
- [Referensi REST API](/rest-api-reference/) – dokumentasi endpoint secara detail  

{{<article-feedback>}}