¿Dónde deberían estar los valores de los parámetros para esta API REST y por qué?

Question

Tengo la siguiente API REST:

POST /users/martin/notify/...

Se supone que la API notifica a una lista de usuarios que el usuario Martin tiene algo que decir.La lista de usuarios a notificar puede variar de 1 a mil.¿Dónde debería estar la lista de mil usuarios: Querystring, Encabezado HTTP o el cuerpo de la Solicitud?¿Por qué?

Answer 1

Cuerpo de la solicitud.Los encabezados y las cadenas de consulta a menudo tienen limitaciones de tamaño en la práctica que definitivamente se alcanzarían con mil identificadores.En un nivel más teórico, el cuerpo de la solicitud debe ser la entidad que desea que el servidor procese a través de POST.Los encabezados son para metadatos de nivel de protocolo sobre esa entidad;es decir, información que ayuda a que se procese la entidad, pero no la entidad en sí.Las cadenas de consulta son parte del identificador del recurso y tampoco una representación de ese recurso.