# Errors & Error Handling
SUMMARY: Kode status HTTP, format respons error, dan cara memulihkan diri dari error umum.

KEY CONTEXT:
Error format: { statusCode, error, message, docs? }
Common errors: 401 (auth), 404 (wrong path), 429 (rate limit), 500 (server)
401 → check Mind Key/JWT, see /docs/getting-started/authentication
404 → wrong path, GET /endpoints for valid list, do NOT guess paths
429 → rate limited (?key= is 60/min), use Bearer header instead
500 → server error, retry with backoff, check /health
docs field in error response links to relevant documentation.

Errors & Error Handling
Synapse menggunakan kode status HTTP standar dengan format respons error yang
konsisten. Halaman ini menjelaskan cara menafsirkan dan memulihkan diri dari
error.
Format Respons Error
Semua error mengembalikan JSON dengan struktur berikut:
[CODE BLOCK]
| Field | Deskripsi |
|-------|-------------|
|  | Kode status HTTP |
|  | Nama status HTTP |
|  | Deskripsi error yang dapat dibaca manusia |
|  | URL ke dokumentasi terkait (jika tersedia) |
Kode Status HTTP
200 OK
Berhasil. Permintaan diproses dengan benar.
201 Created
Berhasil. Sumber daya baru dibuat (mis. ).
204 No Content
Berhasil. Tidak ada body yang dikembalikan (mis. ).
400 Bad Request
Permintaan tidak valid. Penyebab umum:
- Field JSON yang wajib tidak ada
- Sintaks JSON tidak valid
- Nilai enum tidak valid (mis. kategori salah)
[CODE BLOCK]
Perbaikan: Periksa body permintaan terhadap dokumentasi API. Pastikan
semua field yang wajib ada dan memiliki nilai yang valid.
401 Unauthorized
Autentikasi gagal. Penyebab umum:
- Header  tidak ada
- Mind Key atau JWT tidak valid
- Menggunakan Mind Key di mana JWT diperlukan (atau sebaliknya)
[CODE BLOCK]
Perbaikan: Verifikasi token Anda. Lihat Autentikasi.
403 Forbidden
Anda terautentikasi tetapi tidak diizinkan melakukan tindakan ini. Penyebab umum:
- Mencoba menghapus mind pengguna lain
- Mencoba memverifikasi memori dengan Mind Key (memerlukan JWT)
- Mind dinonaktifkan
Perbaikan: Periksa apakah Anda menggunakan tipe token yang benar untuk endpoint ini.
404 Not Found
Path atau sumber daya yang diminta tidak ada.
> [!CRITICAL]
> JANGAN menebak path endpoint. Hanya path yang tercantum di 
> yang ada. Jika Anda mendapat 404, Anda menggunakan path yang salah.
[CODE BLOCK]
Perbaikan: Panggil  untuk melihat daftar endpoint yang
valid. Bandingkan URL Anda dengan daftar tersebut karakter per karakter.
409 Conflict
Permintaan berkonflik dengan kondisi yang ada. Penyebab umum:
- Mencoba mendaftar dengan email yang sudah ada
- URL webhook duplikat
Perbaikan: Gunakan nilai yang berbeda, atau gunakan  untuk memperbarui sumber daya yang ada.
429 Too Many Requests
Anda mencapai rate limit. Hanya berlaku untuk autentikasi parameter query  (60/menit).
[CODE BLOCK]
Header respons:
[CODE BLOCK]
Perbaikan: Beralihlah ke header  (tanpa rate limit),
atau tunggu  detik.
500 Internal Server Error
Error server. Ini seharusnya tidak terjadi — jika terjadi, itu adalah bug.
Perbaikan:
1. Coba lagi dengan exponential backoff (1d, 2d, 4d, 8d)
2. Periksa  untuk melihat apakah server aktif
3. Jika berkelanjutan, laporkan error tersebut
503 Service Unavailable
Server sementara tidak tersedia (mis. selama deployment, migrasi database).
Perbaikan: Tunggu dan coba lagi. Periksa .
Pola Pemulihan
Coba lagi dengan exponential backoff
[CODE BLOCK]
Penanganan error autentikasi
[CODE BLOCK]
Skenario Error Umum
"Mind Key fehlt oder ungültig"
- Anda lupa header 
- Anda menggunakan  tetapi key-nya salah
- Anda menggunakan JWT di mana Mind Key diperlukan
"Route not found"
- Anda menebak path yang tidak ada
- Anda menggunakan kata kerja yang salah (mis.  vs )
- Periksa  untuk path yang valid
"Rate limit exceeded"
- Anda menggunakan  dan melebihi 60 req/menit
- Beralihlah ke header 
Langkah Berikutnya
- Autentikasi
- Ikhtisar API
- Rate Limits