Yanıtlar ve durum kodları

Action’ın dönüş tipi, gövdenin nasıl temsil edileceğini belirler. Özellikle doğrudan değer ile Result<T, E> arasındaki farkı göz önünde bulundurun.

Dönüş tipi tablosu#

Oluşturma ve boş yanıt#

Created::new("/users/42", dto) 201, Location ve JSON gövdesi üretir. NoContent 204 için açık seçimdir. Created::empty() gövde oluşturmaz; Created<()> ise JSON null üretir.

#[delete("/:id")]
async fn remove(&self) -> Result<NoContent, HttpApiError> {
    // Gerçek uygulamada önce domain service ile silme işlemini tamamlayın.
    Ok(NoContent)
}

Bu parça yalnız response seçimini gösterir; herhangi bir kayıt silmez. Result<(), E> kendiliğinden 204 anlamına gelmez.

Header ve cookie ekleme#

Typed body’yi koruyarak ek metadata yazmak için PassthroughResponseContext kullanın. Action veya serialization başarısız olursa staged metadata atılır. Cookie örneği bu yolu tam controller içinde gösterir.

Created, Accepted, NoContent, streaming ve ResponseBuilder gibi kendi status otoritesi olan yanıtların status’ünü passthrough ile keyfi değiştirmeyin.

Manual response#

Raw &mut Response kullanıyorsanız action manual/unit dönüş yolunda olmalıdır. Raw response ile typed return karıştırılmaz. Tam response sözleşmesi için ResponseBuilder, dosyalar için StaticFileResponse, event’ler için SseResponse kullanabilirsiniz.

Hata dönüşümü#

Action’ın error türü IntoResponse + Send sağlayabilir; her domain hatası HttpApiError olmak zorunda değildir. Bir uygulama hatasının HTTP yanıtına başarıyla yazılması teknik response-write hatası sayılmaz. Bir sonraki sayfa özel hata sözleşmesini gösterir.