Lewati ke konten utama

Kode Error

Referensi untuk kode error GoValid dan artinya.

Kode Status HTTP​

KodeArtiPenyebab Umum
200OKRequest berhasil
201CreatedResource berhasil dibuat
400Bad RequestBody atau parameter request tidak valid
401UnauthorizedAutentikasi hilang atau tidak valid
403ForbiddenIzin tidak cukup
404Not FoundResource tidak ada
409ConflictResource sudah ada
422Unprocessable EntityError validasi
429Too Many RequestsBatas rate terlampaui
500Internal Server ErrorError server
503Service UnavailableMaintenance sementara

Error Autentikasi​

Kode ErrorPesanSolusi
INVALID_CREDENTIALSEmail atau password salahPeriksa kredensial, reset password
ACCOUNT_DISABLEDAkun telah dinonaktifkanHubungi support
EMAIL_NOT_VERIFIEDAlamat email belum diverifikasiPeriksa inbox untuk email verifikasi
TOKEN_EXPIREDAccess token telah kedaluwarsaRefresh token atau login kembali
INVALID_TOKENToken tidak validLogin kembali untuk mendapatkan token baru
INVALID_2FA_CODEKode 2FA salahPeriksa aplikasi authenticator, gunakan backup code
2FA_REQUIREDTwo-factor authentication diperlukanAktifkan 2FA atau berikan kode 2FA
API_KEY_EXPIREDAPI key telah kedaluwarsaBuat API key baru
API_KEY_REVOKEDAPI key telah dicabutBuat API key baru

Error QR Code​

Kode ErrorPesanSolusi
QR_NOT_FOUNDQR code tidak adaPeriksa ID QR code
QR_EXPIREDQR code telah kedaluwarsaBuat QR code baru
QR_REMOVEDQR code telah dihapusHubungi pemilik QR code
QR_PASSWORD_REQUIREDPassword diperlukan untuk melihatMasukkan password yang benar
QR_PASSWORD_INVALIDPassword salahPeriksa password
QR_LIMIT_EXCEEDEDBatas QR code terlampauiUpgrade paket atau tunggu reset
INVALID_QR_TYPETipe QR tidak validPeriksa tipe QR yang tersedia
INVALID_SECURITY_LEVELLevel keamanan tidak validPeriksa level keamanan yang tersedia
BULK_LIMIT_EXCEEDEDBatas pembuatan massal terlampauiKurangi ukuran batch atau upgrade paket

Error Finansial​

Kode ErrorPesanSolusi
PAYMENT_FAILEDPemrosesan pembayaran gagalPeriksa metode pembayaran, coba lagi
INSUFFICIENT_CREDITSKredit tidak cukupTop up kredit
PLAN_LIMIT_REACHEDBatas paket tercapaiUpgrade paket
SUBSCRIPTION_ACTIVELangganan sudah aktifKelola langganan yang ada
SUBSCRIPTION_NOT_FOUNDLangganan tidak ditemukanPeriksa status langganan
INVOICE_NOT_FOUNDInvoice tidak ditemukanPeriksa ID invoice
INVALID_COUPONKode kupon tidak validPeriksa kode kupon dan kedaluwarsa
COUPON_EXPIREDKode kupon telah kedaluwarsaGunakan kode kupon yang valid

Error API​

Kode ErrorPesanSolusi
RATE_LIMIT_EXCEEDEDTerlalu banyak requestTunggu dan coba lagi, periksa batas rate
INVALID_REQUESTBody request tidak validPeriksa format dan field request
VALIDATION_ERRORValidasi field gagalPeriksa persyaratan field
RESOURCE_NOT_FOUNDResource yang diminta tidak ditemukanPeriksa ID resource
PERMISSION_DENIEDIzin tidak cukupPeriksa izin API key
INTERNAL_ERRORError server internalCoba lagi, hubungi support jika berlanjut

Error Integrasi​

Kode ErrorPesanSolusi
WEBHOOK_FAILEDPengiriman webhook gagalPeriksa endpoint webhook
WEBHOOK_INVALID_URLURL webhook tidak validGunakan URL HTTPS yang valid
OAUTH_ERRORAutentikasi OAuth gagalRe-otorisasi integrasi
PLUGIN_ERRORPlugin mengalami errorPeriksa konfigurasi plugin

Error Keamanan​

Kode ErrorPesanSolusi
RISK_LOGIN_BLOCKEDLogin diblokir karena risikoVerifikasi identitas, hubungi support
DEVICE_NOT_TRUSTEDPerangkat tidak tepercayaPercayai perangkat atau masukkan 2FA
SIGNATURE_INVALIDDigital signature tidak validQR code mungkin telah dirusak
ENCRYPTION_ERROREnkripsi/dekripsi gagalHubungi support

Format Respons Error​

Semua error API mengikuti format ini:

{
  "error": "ERROR_CODE",
  "message": "Deskripsi yang dapat dibaca manusia",
  "details": {
    "field": "field_spesifik",
    "issue": "deskripsi masalah"
  }
}

Contoh​

{
  "error": "VALIDATION_ERROR",
  "message": "Validasi request gagal",
  "details": {
    "title": "Judul diperlukan",
    "qr_type": "Tipe QR tidak valid. Harus salah satu dari: url, text, email, document"
  }
}

Header Rate Limit​

Saat Anda menerima error 429, periksa header ini:

HeaderDeskripsi
X-RateLimit-LimitMaksimum request yang diizinkan
X-RateLimit-RemainingSisa request dalam window
X-RateLimit-ResetTimestamp Unix saat limit reset
Retry-AfterDetik untuk menunggu sebelum retry

Terkait​