<!-- Fonte: https://developers.conectaai.io/erros · conecta/ai Desenvolvedores -->
> Formato das respostas de erro da API do conecta/ai, o campo code estável para comparar no seu código e a lista completa de códigos.

# Erros

Toda resposta de erro tem o mesmo corpo:

```json
{
  "error": "Parâmetro desconhecido: stauts.",
  "code": "invalid_parameter"
}
```

- `code` é estável. Compare por ele no seu código.
- `error` é uma frase em português para quem lê o log. Ela pode melhorar com o tempo.
- No `429`, o corpo traz também `retryAfter`, em segundos.

Toda resposta, de sucesso ou de erro, leva o cabeçalho `X-Request-Id`. Ao falar com o suporte sobre uma falha, informe esse valor.

## Códigos

## Parâmetros

Parâmetro que a operação não conhece é recusado com `400`, para um erro de digitação como `stauts=open` não devolver a lista inteira sem aviso. Valor fora da faixa também é `400`, e a frase diz qual parâmetro.

Identificador que não existe na sua organização é `404`, mesmo quando o recurso existe em outra.
