Lewati ke konten utama

Autentikasi

Setiap request ke ACI Partner API wajib menyertakan access token, kecuali gagal dengan 401 Unauthorized. Token didapat lewat alur OAuth2 client credentials.

Alur​

  1. Kirim client_id dan client_secret sebagai HTTP Basic Auth (base64 client_id:client_secret) ke POST /api/v1/token.
  2. Set grant_type=client_credentials di body.
  3. Pakai access_token dari response sebagai header Authorization: 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.