Autentikasi
Setiap request ke ACI Partner API wajib menyertakan access token, kecuali gagal dengan 401 Unauthorized. Token didapat lewat alur OAuth2 client credentials.
Alur
- Kirim
client_iddanclient_secretsebagai HTTP Basic Auth (base64client_id:client_secret) kePOST /api/v1/token. - Set
grant_type=client_credentialsdi body. - Pakai
access_tokendari response sebagai headerAuthorization: Bearer <ACCESS_TOKEN>di semua endpoint lain.
Masa berlaku token
Token berlaku 7 hari (lihat expires_in pada response, dalam detik). Simpan dan pakai ulang token sampai kedaluwarsa — jangan minta token baru di setiap request.
Request token baru hanya saat:
- Token sudah kedaluwarsa, atau
- Request lain gagal dengan
401 Unauthorized.
Meminta token di luar dua kondisi ini membebani layanan tanpa manfaat tambahan.
Ambil token
curl -X POST https://sandbox-partner-gateaway-aci.bmsecure.id/api/v1/token \
-H "Authorization: Basic <BASE64(client_id:client_secret)>" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&scope=courier,places"
Response 200:
{
"access_token": "<ACCESS_TOKEN>",
"token_type": "Bearer",
"expires_in": 604800
}
Response 401 (client ID/secret salah):
{
"message": "Invalid client: client is invalid"
}
Cek validitas token
Untuk memverifikasi token masih aktif tanpa memanggil endpoint bisnis, gunakan POST /api/v1/token/check dengan header Authorization: Bearer <ACCESS_TOKEN>.
Response 200:
{
"message": "Valid Token"
}
Response 401:
{
"message": "Invalid Token"
}
Kredensial sandbox vs produksi
Kredensial sandbox dan produksi berbeda dan sama-sama tidak bisa diterbitkan sendiri — lihat Mulai cepat dan Environment.