Erros

Toda resposta de erro da API segue o mesmo formato:

{
  "statusCode": 401,
  "message": "Unauthorized",
  "error": "Unauthorized"
}

statusCode: código HTTP do erro (repete o status da resposta).

message: descrição do erro. Pode ser uma string única ou uma lista de strings (comum em erros de validação, um item por campo inválido).

error: nome curto do erro.

Status codes possíveis

Status	Significado	Quando ocorre
`400`	Bad Request	Validação do payload falhou (algumas operações usam `422` para o mesmo caso — confira a referência do endpoint)
`401`	Unauthorized	Token ausente, inválido ou expirado
`403`	Forbidden	Token válido, mas sem a permissão exigida pela operação
`404`	Not Found	Recurso não encontrado (ex.: id inexistente)
`409`	Conflict	Estado atual do recurso não permite a operação (ex.: cancelar um link já pago)
`422`	Unprocessable Entity	Validação do payload falhou (ver nota acima sobre `400`)
`429`	Too Many Requests	Limite de requisições excedido — veja Limites de Requisição

Cada endpoint na referência documenta quais desses status ele pode retornar e, quando aplicável, uma descrição mais específica do cenário de erro.

Limites de Requisição — limites de requisições por segundo.