Une réponse reposante doit-elle inclure ou exclure le résultat vide?

Question

Voici un api qui utilisent un lot d'ID utilisateur pour obtenir les utilisateurs

GET/user/{user_id}

user_id: virgule chaîne séparée

par exemplehttp://user.example.com/user/1,2,3

Maintenant, j'ai 2 utilisateurs id 1 et 2, mais aucun utilisateur pour id 3.

Et la réponse doit inclure l'utilisateur vide ou ne comprennent pas?

Inclure exemple:

{ "id":"1", "name":"Chris", "age":29 }, { "id":"2", "name":"Max", "age":30 }, { "id":"3" }

Excluez exemple:

{ "id":"1", "name":"Chris", "age":29 }, { "id":"2", "name":"Max", "age":30 }

Answer 1

S'il n'y a aucune ressource avec l'identifiant donné, il ne doit pas être inclus dans la réponse.

---

Si vous avez une collection d'utilisateurs, essayez d'identifier avec un nom pluriel (/users au lieu de /user) et utiliser un paramètre de chaîne de requête pour filtrer, comme /users?ids=1,2,3.

Lors de l'utilisation JSON pour représenter une collecte, l'utilisation d'un tableau (qui commence par [ et se termine par ] et sépare les valeurs avec ,).

---

Pour plus de détails concernant les codes d'état qui doivent être utilisées lors de la demande d'une représentation d'une collection ou une représentation d'une seule ressource, reportez-vous à cette answer.