1. Mendapat akses
Sekali di awal, lalu setiap 15 menit.
- 1Toko
Pemilik toko membuka Pengaturan → Integrasi API, membuat integrasi, mencentang izin yang perlu, lalu memberimu client ID dan client secret. Secret hanya ditampilkan sekali. Integrasi bisa dibuat di paket Gold ke atas.
- 2Sistemmu
POST /v1/tokenKirim client ID dan secret sebagai HTTP Basic. Jawabannya access token (tka_…) yang berlaku 15 menit.
- 3Sistemmu
GET /v1/whoamiKirim token sebagai "Authorization: Bearer tka_…" di setiap panggilan. Whoami menunjukkan nama integrasi, izin, dan batas permintaannya; cocok untuk memeriksa pengaturan.
- 4Sistemmu
Saat token habis, API menjawab 401 access_token_expired. Minta token baru dengan client ID dan secret yang sama; tidak ada refresh token.
- Client ID dan secret hanya diterima di /v1/token. Simpan secret seperti kata sandi.
- Ganti secret tanpa jeda: buat secret baru di halaman integrasi, pasang, lalu cabut yang lama. Yang dicabut langsung ditolak, termasuk token yang sudah terbit.