#define API http://localhost:80/api/v1/resources.
Ao fazer um POST em resources
, o usuário(dev) pode registrar/incluir um N número de resources.
Supondo que algum(uns) registro não pôde ser inserido, mas o restante foi com sucesso. Como poderia ser o response? Qual status? 200 ok, 201, outro? Qual padrão deve-se seguir?
Adicione um comentário
|
1 Resposta
Em situações similares eu utilizo o seguinte padrão:
200
: OK
Nenhum erro encontrado.202
: Accepted
Sucesso ao enviar o payload. não é considerado um status de erro; retorne um payload contendo os descritores individuais de sucesso ou erro.40*
: Bad Request / Unauthorized / Forbidden / Not Found / etc.
Erros de validação.500
: Internal Server Error
A aplicação lançou uma exceção.Opcional -
207
: Multi-Status
(WebDAV)
Se seu cliente suporta WebDAV ou XML, responda com um payload multi-status, indicando os resultados de cada operação. A RFC que define 207/Multi-Status estabelece XML como formato desejado, o que pode evitar sua implementação em clientes baseados em REST/Json.
-
-
@DanielVieiraJunior Sim, este padrão atenderia. Se desejar pode até incluir uma coleção com os registros corretamente comitados (dependendo das suas necessidades.) Commented 28/11/2016 às 21:12