error-codes.md
docs/03-api/error-codes.md
Contoh isi file untuk sistem antrian. Sesuaikan dengan implementasi proyek Anda.
# Error codes
Contoh envelope:
```json
{
"success": false,
"message": "Kapasitas antrian sudah penuh",
"error": { "code": "QUEUE_FULL" },
"meta": { "request_id": "req-example" }
}
```
| HTTP | Code | Tindakan client |
| --- | --- | --- |
| 401 | UNAUTHORIZED | Periksa credential/token; login kembali bila perlu |
| 403 | FORBIDDEN | Hentikan akses resource yang tidak diizinkan |
| 404 | ANTRIAN_NOT_FOUND | Tampilkan data tidak ditemukan |
| 409 | QUEUE_FULL | Pilih layanan/waktu lain |
| 409 | IDEMPOTENCY_CONFLICT | Periksa apakah ini operasi baru atau retry; jangan otomatis mengganti key pada retry |
| 422 | VALIDATION_ERROR | Perbaiki input |
| 500 | INTERNAL_ERROR | Gunakan request_id untuk investigasi; jangan bocorkan stack trace |