HTTP Status Code
Código de Status HTTP
Um código de status HTTP é um número de três dígitos em uma resposta. Ele indica o resultado padrão da solicitação e a qual grupo de resultado ela pertence.
Outro exemplo
Uma API de importação retorna 202 e uma URL de status enquanto o trabalho continua. Ela retorna 201 com `Location` após uma criação imediata. Retorna 409 para um conflito de versão e 422 para campos CSV com significado inválido. Um corpo de problema em JSON adiciona detalhes úteis sem alterar o que o código significa.
Partes principais
- 01Classe de status
- 02Código registrado
- 03Metadados e corpo da resposta
Use-o quando
Retorne o código registrado mais exato que corresponda ao resultado. Adicione cabeçalhos úteis e um corpo de erro estável quando necessário.
Não o use quando
Não retorne 200 para todas as falhas de negócio. Também evite erros tão específicos que revelem detalhes secretos de autorização.
Nome usado no código
1xx informational, 2xx success, 3xx redirection, 4xx client, 5xx server Antes de lançar
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome: Complete the task with Código de Status HTTP (HTTP Status Code). User context: Uma API de importação retorna 202 e uma URL de status enquanto o trabalho continua. Ela retorna 201 com `Location` após uma criação imediata. Retorna 409 para um conflito de versão e 422 para campos CSV com significado inválido. Um corpo de problema em JSON adiciona detalhes úteis sem alterar o que o código significa. Technical concept or control: Código de Status HTTP (HTTP Status Code). Why it fits: Retorne o código registrado mais exato que corresponda ao resultado. Adicione cabeçalhos úteis e um corpo de erro estável quando necessário. Do not use it when: Não retorne 200 para todas as falhas de negócio. Também evite erros tão específicos que revelem detalhes secretos de autorização. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): O padrão cobre apenas o escopo listado. Ele não escolhe o estilo visual, decisão do produto ou exemplo de Vibulary. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
Conferir este pedido
Review how Código de Status HTTP (HTTP Status Code) is used now. Definition: Um código de status HTTP é um número de três dígitos em uma resposta. Ele indica o resultado padrão da solicitação e a qual grupo de resultado ela pertence. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.