Dove dovrebbero essere i valori dei parametri per questa API REST e perché?

Question

Ho la seguente API REST:

POST /users/martin/notify/...

Si suppone che l'API notifichi a un elenco di utenti che l'utente Martin ha qualcosa da dire.L'elenco degli utenti da notificare può variare da 1 a mille.Dove dovrebbe essere l'elenco di mille utenti: Querystring, HTTP Header o il corpo della richiesta?Perché?

Answer 1

Corpo della richiesta.Le intestazioni e le stringhe di query hanno spesso limitazioni di dimensioni nella pratica che verrebbero sicuramente raggiunte con un migliaio di identificatori.A un livello più teorico, il corpo della richiesta dovrebbe essere l'entità che si desidera venga elaborata dal server tramite POST.Le intestazioni sono per i metadati a livello di protocollo su quell'entità;ovvero, informazioni che aiutano l'entità a essere elaborata, ma non l'entità stessa.Le stringhe di query fanno parte dell ' identificatore della risorsa e non una rappresentazione di tale risorsa.