Codice/messaggio API REST per risorsa madre mancante

Question

Sto cercando indicazioni per il codice di risposta corretto & messaggio quando si richiede una risorsa che fa parte di un'altra risorsa.

Ad esempio, una richiesta GET on:

utenti/{id}

in cui l'utente non esiste sarebbe tornato un 404, con un messaggio di utente risorsa non trovato.

La mia domanda è, quale dovrebbe essere il seguente ritorno quando nessun utente risorsa viene trovato:

utenti/{id}/amici

Attualmente sto tornando lo stesso codice/messaggio come nel primo esempio . Dovrei restituire un messaggio relativo specificamente alla risorsa amici? Personalmente ritengo sia più utile rendere il client API consapevole del fatto che la risorsa genitore non viene trovata, in caso si abbia una catena di URI più grande.

Answer 1

In questo particolare esempio, se il punto è quello di consentire al client di distinguere tra una richiesta di amici per un utente inesistente e una richiesta di amici per un utente che semplicemente non ha amici, penso che sarebbe più sensato per restituire 404 nel primo caso e 200 con un set vuoto nel secondo.

In altre parole, "nessuno" è un valore valido per gli amici. Non esiste un caso in cui un utente esista ma la sua (potenzialmente vuota) lista di amici no, quindi non c'è mai alcuna ambiguità nell'emettere un 404 per la risorsa genitore.

Answer 2

Sarei tentato di restituire un'intestazione 400 Bad Request e inserire il messaggio di errore nel corpo della risposta. Sfortunatamente non c'è una risposta giusta o sbagliata in questo scenario, quindi scegli quello che funziona meglio per te e per la tua applicazione.