HTTP method'ları, bir kaynak üzerindeki niyetinizi belirtir; status code'lar sunucunun kodlanmış yanıtıdır. Method'lar için iki özellik önemlidir: safe (salt-okunur, yan etkisi yok) ve idempotent (tekrarlamak aynı sonucu verir — güvenli retry'lar için önemli).
| Method | Amaç | Safe | Idempotent |
|---|
| GET | Bir kaynağı oku | Yes | Yes |
| POST | Oluştur / bir eylem tetikle | No | No |
| PUT | Bir kaynağı değiştir | No | Yes |
| PATCH | Kısmen güncelle | No | No* |
| DELETE | Bir kaynağı kaldır | No | Yes |
| HEAD | GET gibi, yalnızca header | Yes | Yes |
Idempotency ayrımı pratiktir: PUT ve DELETE idempotent olduğu için, bir istemci timeout'tan sonra onları güvenle retry edebilir; idempotent olmayan bir POST'u retry etmek bir kopya oluşturma riski taşır (klasik çift-tahsilat hatası).
Status code'lar ilk hanelerine göre gruplanır:
1xx Informational request received, continuing (100 Continue, 101 Switching)
2xx Success it worked (200 OK, 201 Created, 204 No Content)
3xx Redirection go elsewhere (301 Moved, 304 Not Modified)
4xx Client error YOUR request is wrong (400, 401, 403, 404, 429)
5xx Server error the SERVER failed (500, 502, 503, 504)
En önemli çizgi, 4xx vs 5xx ayrımıdır: 4xx, istemcinin yanlış bir şey gönderdiği anlamına gelir (hatalı girdi, doğrulanmamış, bulunamadı) — değişmeden retry etmek fayda etmez; 5xx, sunucunun başarısız olduğu anlamına gelir — (backoff ile) retry etmek başarılı olabilir. Günlük olanları ezbere bilin: 401 (doğrulanmamış) vs 403 (doğrulanmış ama izinli değil), 404 (bulunamadı), 429 (rate limited), 500 (genel sunucu çökmesi), 502/503/504 (bad gateway / kullanılamıyor / gateway timeout — genellikle bir upstream veya aşırı yük problemi).
Bu kodlar her istemci ile sunucu arasındaki ortak sözleşmedir; bu yüzden buradaki akıcılık, API inşa eden veya tüketen herkesten beklenir. Mülakat yapanlar, gerçek anlayışı ortaya çıkaran ayrımları araştırır: 401 vs 403, PUT vs PATCH ve özellikle retry'ların güvenli olup olmadığını doğrudan yöneten idempotency — dağıtık sistemlerde ve ödeme akışlarında çekirdek bir kaygı. Doğru status code döndürmek ayrıca API'nizi öngörülebilir kılar ve cache'ler, proxy'ler ve istemci kütüphaneleri tarafından doğru işlenmesini sağlar; bu yüzden bu bilgi sadece bir ayrıntı değil, iyi API tasarımını şekillendirir.
Junior'dan Senior'a detaylı cevaplarla bir BT mülakat soruları kütüphanesi.
Bağış Yap