Lewati ke konten utama

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)​

errorPenyebabYang harus dilakukan
access_deniedPengguna menekan Tolak di halaman persetujuanTampilkan pesan bahwa login dibatalkan; sediakan tombol coba lagi.
login_requiredprompt=none dan pengguna belum loginArahkan ulang tanpa prompt=none.
consent_requiredprompt=none dan scope belum disetujuiArahkan ulang tanpa prompt=none.
invalid_scopeScope tidak dikenal atau tidak diizinkan untuk clientPeriksa scope yang didaftarkan.
invalid_requestParameter wajib tidak ada atau salah, mis. PKCE tidak dikirimPerbaiki permintaan.
server_error, temporarily_unavailableGangguan sementara di MyJNECoba 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​

HTTPerrorPenyebab umum
400invalid_grantCode salah, kedaluwarsa (lebih dari 10 menit), sudah dipakai, redirect_uri atau code_verifier tidak cocok; refresh token kedaluwarsa, sudah dipakai, atau dicabut.
400invalid_requestParameter wajib tidak ada.
400invalid_scopeScope tidak diizinkan, termasuk scope data pengguna pada client_credentials.
400unauthorized_clientGrant tidak diizinkan untuk client ini, mis. client publik memakai client_credentials.
401invalid_clientclient_id/client_secret salah, secret sudah dirotasi, atau client dinonaktifkan.
403Permintaan dari IP di luar allowlist client, atau Origin browser tidak terdaftar.
429Batas permintaan per menit terlampaui. Tunggu sesuai header Retry-After.

Di endpoint userinfo​

HTTPerrorYang harus dilakukan
401invalid_tokenPerbarui access token dengan refresh token, atau minta login ulang.

Penanganan yang disarankan​

  • Jangan coba ulang otomatis untuk error 4xx selain 429.
  • Untuk 5xx dan kegagalan jaringan, coba ulang dengan jeda bertahap (mis. 1, 2, 4 detik), maksimal 3 kali.
  • Jangan pernah mencatat client_secret, token, atau code di log.