Penanganan Kesalahan

Kode status HTTP, bentuk respon error, dan cara handle-nya kalau request kamu gagal.

Wazapin pakai kode status HTTP standar. Tiap respon error ada field detail yang bisa kamu tampilin ke user atau simpan di log buat debugging.

Kode status yang sering kamu temui

Payload atau query param kamu nggak valid.

Token nggak ada atau nggak valid.

Token kamu nggak punya permission yang dibutuhin.

Resource yang kamu cari nggak ketemu.

Request kamu bentrok sama kondisi resource sekarang.

Validasi gagal. Cek lagi payload dan isi field-nya.

Kebanyakan request — kena rate limit. Coba lagi pakai exponential backoff.

Ada yang error di server kami. Cek detail responnya, kalau masih kejadian hubungi support.

{
  "title": "Bad Request",
  "status": 400,
  "detail": "to is required"
}

Simpan body respon dan metadata request ke log — biar gampang tracing kalau ada insiden.
Retry cuma buat error 429 dan 5xx pakai exponential backoff.
Jangan retry error 4xx sebelum kamu benerin payload-nya dulu.