Eksik üst kaynak için API kodu/iletisi

Question

Başka bir kaynağın bir parçasını oluşturan bir kaynak için istendiğinde doğru yanıt kodu & iletisiyle ilgili bir kılavuzluk arıyorum. Örneğin

, bir GET isteği:

kullanıcılar/{id} Kullanıcı bulunamadı kullanıcı kaynağın bir mesajla, bir 404 döneceğini yok

. Aşağıdaki dönüş Kullanıcı kaynak bulunursa gereken Sorum şu

:

kullanıcılar/{id}/arkadaş

Şu anda ilk örnekte olduğu gibi aynı kod/mesajı iade ediyorum . Özellikle arkadaş kaynağına ilişkin bir mesaj atmalı mıyım? Kişisel olarak, daha büyük bir URI zincirine sahip olmanız durumunda, API istemcisinin üst kaynağın bulunmadığını bilmesini sağlamak için daha yararlı olduğunu düşünüyorum.

Answer 1

Bu özel örnekte, istemcinin bir arkadaş olmayan bir kullanıcı için bir istek isteğini ayırt etmesine izin vermesi ve arkadaşlarının yalnızca bir arkadaşı olmayan bir kullanıcı için istekte bulunması, en mantıklı olacağını düşünüyorum. ilk durumda 404 ve ikincide boş bir set ile 200 döndürmek için. Başka bir deyişle, "hiçbiri" arkadaşlar için geçerli bir değerdir. Bir kullanıcının var olduğu bir durum yoktur, ancak (potansiyel olarak boş) arkadaş listesi yoktur, dolayısıyla ana kaynak için 404 yayınlama konusunda hiçbir belirsizlik yoktur.

Answer 2

400 Bad Request üstbilgisini döndürmek isteyebilir ve hata iletisini yanıtın gövdesine yerleştiririm. Maalesef bu senaryoda doğru ya da yanlış bir cevap yoktur, bu yüzden sizin ve uygulamanız için en iyi olanı seçin.