HTTP 202 Accepted ne anlama gelir?
HTTP 202 Accepted, isteğin işlenmek üzere kabul edildiğini fakat işlemenin tamamlanmadığını bildirir. Daha sonra başarıya ulaşılacağını garanti etmez. RFC 9110'un 202 tanımı, kabul ile tamamlanmanın ayrı olduğunu açıklar.
Bir raporun hazırlanması uzun sürüyorsa tarayıcıyı tek bağlantı boyunca bekletmek yerine iş kaydı oluşturabilirsiniz. İstemci kabul yanıtını alır, sonra işin durumunu ayrı bir kaynaktan izler. Burada önemli ürün kararı şudur: kullanıcı raporu hemen indirebiliyor mu, yoksa henüz hazırlanma sürecinde mi?
202 yalnızca ikinci durumu anlatır. Arayüzde doğrudan “Rapor hazır” göstermek, kullanıcıya henüz doğrulanmamış bir sonuç söyler. MDN 202 açıklaması, işlemenin daha sonra başarısız olabileceğini de belirtir.
Kabul yanıtı hangi bilgileri içerebilir?
İş kimliği ve durum adresi, istemcinin başlattığı işlemi sonradan bulmasını sağlar. Aşağıdaki örnek POST /exports sonrasında dönen temsili yanıttır; adresler ve alan adları bir uygulama sözleşmesi örneğidir:
HTTP/1.1 202 Accepted
Content-Type: application/json
Cache-Control: no-store
Location: /operations/export-42
{
"id": "export-42",
"state": "queued",
"statusUrl": "/operations/export-42"
}
Bu tasarımda Location izlenecek kaynağı gösterir. Her 202 yanıtında bu başlığın zorunlu olduğunu veya JSON alanlarının HTTP standardınca belirlendiğini varsaymayın. İstemciye takip yolunu nasıl sunduğunuzu belgeleyin. Microsoft'un asenkron istek-yanıt deseni, uzun süren işler için bu yaklaşımı ele alır.
Kabul yanıtını vermeden önce neyi kalıcı hale getirdiğinizi de belirleyin. Yalnızca bellekte oluşturulmuş bir görev, süreç yeniden başladığında kaybolabilir. İş kaydı ile kuyruğa iletimin birbirinden kopabildiği bir tasarımda, kabul edilmiş ama hiç işlenmeyen kayıtları nasıl toparlayacağınızı düşünün. 202, bu dayanıklılığı kendiliğinden sağlamaz.
Durum kaynağında 200 dönmesi işin bittiğini gösterir mi?
Durum kaynağının GET isteğine 200 dönmesi, durum bilgisinin başarıyla alındığını gösterir. İş hâlâ çalışıyor olabilir. Örnekte istemci aynı durum adresini okuduğunda şu temsili yanıtı alabilir:
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
{
"id": "export-42",
"state": "running"
}
İş tamamlandığında yine aynı kaynaktan sonuç bağlantısı okunur:
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
{
"id": "export-42",
"state": "succeeded",
"resultUrl": "/exports/export-42.csv"
}
Bu sözleşmede queued ve running bekleme durumları, succeeded ve failed son durumlardır. İlerleme yüzdesi ancak anlamlı biçimde hesaplanabiliyorsa eklenmelidir. Yüzde uydurmak yerine işin kuyruğa alındığını veya işlendiğini doğru söylemek daha kullanışlıdır.
İş başarısız olursa istemci ne görmeli?
Bir işin başarısızlığı ile durum kaynağını okuyamamak farklı olaylardır. İşin durumunu başarıyla okuyan bir GET, uygulama durumu failed olsa da 200 dönebilir. Örnek bir gövde şöyledir:
{
"id": "export-42",
"state": "failed",
"error": {
"code": "EXPORT_SOURCE_UNAVAILABLE",
"message": "Rapor kaynağına ulaşılamadı."
}
}
Durum endpoint'inin kendisi yetkisiz veya erişilemezse uygun HTTP hatası ayrıca döner. Problem Details rehberi, bu HTTP hata gövdeleri için ortak bir model açıklar. İşe ait hata mesajını sunarken kullanıcıya düzeltme veya yeniden başlatma yolu verin; teknik ayrıntıları geliştirici günlüklerinde tutun.
Polling ve tekrar gönderim nasıl sınırlandırılır?
Polling, durum adresini belirli aralıklarla yeniden okumaktır. Her yanıt geldiğinde anında yeni istek başlatan sınırsız döngü kurmayın. Bekleme aralığı, toplam süre ve kullanıcı sayfadan ayrıldığında iptal davranışı ürün sözleşmesinin parçası olmalıdır. Son duruma ulaşıldığında polling durur.
İstemcinin beklemeyi bırakması, sunucudaki işi iptal ettiği anlamına gelmez. Sunucu iptali gerekiyorsa ayrı bir davranış tanımlayın. İptal talebiyle işin tamamlanması yarışabilir; arayüzü yalnızca iptal düğmesine basıldığı için sonuca karar verecek şekilde kurmayın.
İlk POST yanıtı kaybolursa aynı işi yeniden oluşturma riski vardır. Bunun çözümü durum GET isteğini hızlandırmak değildir; başlatma işleminin tekrar gönderim ve idempotency sözleşmesi gerekir. Webhook idempotency rehberi aynı olayın yeniden işlenmesi sorununu, retry rehberi kontrollü yeniden denemeyi ele alır.
İş kimliğini bilen herkesin durum veya sonuç dosyasını okuyabilmesine izin vermeyin. Başlatan kullanıcıyla yetki ilişkisini koruyun; süresi dolmuş bir işin ne döndüreceğini ve dosyanın ne kadar saklanacağını da belgeleyin. Başarı, başarısızlık, bağlantı kopması ve aynı isteğin iki kez gönderilmesi senaryolarını ayrı ayrı deneyin.
Sık sorulan sorular
202 yanıtından sonra aynı HTTP yanıtı güncellenir mi? Hayır. Sonucu öğrenmek için durum kaynağı gibi ayrı bir iletişim yolu gerekir.
Durum endpoint'i her beklemede 202 dönmeli mi? Zorunlu değildir. Bu örnekte kaynak başarıyla okunduğunda 200 ve gövdede iş durumu kullanılır.
Tarayıcı isteğini iptal etmek sunucu işini durdurur mu? Genel bir garanti yoktur. Sunucu tarafı iptal davranışını ayrıca tasarlayın.

