Kode error
Error mengikuti format standar OAuth:
{ "error": "invalid_grant", "error_description": "invalid refresh token" }
Gunakan nilai error untuk logika program. error_description hanya untuk log dan dapat berubah.
Di callback (redirect ke aplikasi Anda)
error | Penyebab | Yang harus dilakukan |
|---|---|---|
access_denied | Pengguna menekan Tolak di halaman persetujuan | Tampilkan pesan bahwa login dibatalkan; sediakan tombol coba lagi. |
login_required | prompt=none dan pengguna belum login | Arahkan ulang tanpa prompt=none. |
consent_required | prompt=none dan scope belum disetujui | Arahkan ulang tanpa prompt=none. |
invalid_scope | Scope tidak dikenal atau tidak diizinkan untuk client | Periksa scope yang didaftarkan. |
invalid_request | Parameter wajib tidak ada atau salah, mis. PKCE tidak dikirim | Perbaiki permintaan. |
server_error, temporarily_unavailable | Gangguan sementara di MyJNE | Coba lagi beberapa saat lagi. |
Bila client_id atau redirect_uri tidak valid, MyJNE tidak melakukan redirect ke aplikasi Anda; pengguna melihat halaman galat di MyJNE. Ini disengaja untuk mencegah open redirect.
Di endpoint token
| HTTP | error | Penyebab umum |
|---|---|---|
| 400 | invalid_grant | Code salah, kedaluwarsa (lebih dari 10 menit), sudah dipakai, redirect_uri atau code_verifier tidak cocok; refresh token kedaluwarsa, sudah dipakai, atau dicabut. |
| 400 | invalid_request | Parameter wajib tidak ada. |
| 400 | invalid_scope | Scope tidak diizinkan, termasuk scope data pengguna pada client_credentials. |
| 400 | unauthorized_client | Grant tidak diizinkan untuk client ini, mis. client publik memakai client_credentials. |
| 401 | invalid_client | client_id/client_secret salah, secret sudah dirotasi, atau client dinonaktifkan. |
| 403 | Permintaan dari IP di luar allowlist client, atau Origin browser tidak terdaftar. | |
| 429 | Batas permintaan per menit terlampaui. Tunggu sesuai header Retry-After. |
Di endpoint userinfo
| HTTP | error | Yang harus dilakukan |
|---|---|---|
| 401 | invalid_token | Perbarui access token dengan refresh token, atau minta login ulang. |
Penanganan yang disarankan
- Jangan coba ulang otomatis untuk error
4xxselain429. - Untuk
5xxdan kegagalan jaringan, coba ulang dengan jeda bertahap (mis. 1, 2, 4 detik), maksimal 3 kali. - Jangan pernah mencatat
client_secret, token, ataucodedi log.