Risposte diverse in REST

Avere questi tipi completamente diversi di risposte per ciò che è essenzialmente la stessa risorsa renderà estremamente difficile per i destinatari della risposta fare qualcosa di utile con esso.

Un approccio migliore sarebbe essenzialmente quello di unire le due risposte:

[{
  "address":"London, UK",
  "count":31,
  "people":[{
    "name":"Jane",
    "age":72
  },{
   "name":"John",
   "age": "23"
  },
  ....
  ]
},{
 "address":"London, AK, US",
 "count": "12",
 "people": [
   ...
 ]
}
....      

Se ora disponi di una sola città corrispondente, puoi restituire un array con un singolo elemento e mantenere comunque la stessa struttura.

La risposta breve è no, non è una buona pratica. Si rompe legge di Postel . Come @Bart come commentato, sarebbe difficile lavorare con l'API.

La combinazione di entrambe le risposte sembra appropriata, ma dipende dalla rappresentanza effettiva people .

In alternativa alla risposta di @ Bart, presumo che /people -senza filtri- non crei alcun tipo di raggruppamento.

Più facile sarebbe consentire agli utenti di aggiungere più filtri. Ad esempio:

Prima chiamata

GET /people?address=London

{
  "count": 2,
  [
    { "name":"Jane", "age":72, "address": "London, UK"},
    { "name":"Jhon", "age":18, "address": "London, AK, US"}
  ]
}

Seconda chiamata

GET /people?address=London,UK

{
  "count": 1,
  [
    { "name":"Jane", "age":72, "address": "London, UK"}
  ]
}

In questo modo, la rappresentazione di /people rimane la stessa sempre, con o senza filtri. E, naturalmente, il codice di stato è sempre lo stesso.

Tieni presente che ho separato London e UK da coma. Non so se gli indirizzi sono normalizzati o meno. Se lo fossero, potremmo aggiungere un altro parametro di richiesta. Come per esempio ?address=X&country=Y .