Status codes

Todo retorno tem um status code de 3 dígitos. O primeiro dígito já diz muito:

Faixa	Significado	Exemplos no jogo
2xx	deu certo	`200 OK`, `201 Created` (detetive ou nota criada)
4xx	você errou algo	`400` pedido mal feito, `401` sem distintivo, `404` não existe, `409` conflito, `413` grande demais, `415` formato errado, `422` dados inválidos, `429` devagar!
5xx	o servidor errou	`500` erro interno, `503` fora do ar

Todo erro da delegacia vem no mesmo formato:

{
  "error": "missing_detective_key",
  "message": "O escrivão nem levanta os olhos: \"Sem distintivo, sem arquivo.\"",
  "concept": "Faltou o header X-Detective-Key. ...",
  "docs": "/manual/autenticacao"
}

Leia o concept: ele diz exatamente o que corrigir.

429 Too Many Requests: você fez requisições demais em pouco tempo. O header Retry-After diz quantos segundos esperar. No curl, use -i pra ver os headers.