Server ke server (Client Credentials)
Untuk sistem backend yang memanggil API MyJNE atas nama aplikasinya sendiri, tanpa pengguna. Membutuhkan client jenis Layanan.
curl -X POST https://athena.akropolis.my.id/auth/v1/oauth2/token \
-u "CLIENT_ID_ANDA:CLIENT_SECRET_ANDA" \
-d grant_type=client_credentials \
-d scope=shipment.read
{
"access_token": "Q1x8pV0mXk3tR9aZ...",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "shipment.read"
}
Aturan:
- Hanya scope API yang diberikan tim MyJNE untuk client Anda. Scope data pengguna (
openid,profile,email,phone,offline_access) tidak berlaku dan akan ditolak denganinvalid_scope. - Tidak ada refresh token dan ID token. Minta token baru saat yang lama mendekati kedaluwarsa, dan pakai ulang token selama masih berlaku (jangan meminta token per request).
- Client layanan dapat dibatasi ke daftar IP server Anda dan dibatasi jumlah permintaan per menit. Permintaan dari IP lain ditolak
403; melebihi batas ditolak429dengan headerRetry-After.
Autentikasi dengan private_key_jwt
Sebagai pengganti secret, Anda dapat mendaftarkan kunci publik dan menandatangani assertion JWT dengan kunci privat:
curl -X POST https://athena.akropolis.my.id/auth/v1/oauth2/token \
-d grant_type=client_credentials \
-d scope=shipment.read \
-d client_id=CLIENT_ID_ANDA \
-d client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer \
-d client_assertion=eyJhbGciOiJFUzI1NiIs...
Isi assertion: iss dan sub = client_id, aud = alamat endpoint token, jti acak, exp maksimal 5 menit ke depan.