Erros e limites

Erros retornam JSON com a propriedade error. Não use o texto como código estável de negócio; decida primeiro pelo status HTTP.

json

{"error":"Chave inválida ou revogada."}

HTTP	Motivo e ação
`400`	Entrada inválida. Corrija o corpo antes de repetir.
`401`	Chave ausente, inválida ou revogada. Verifique a credencial e sua revogação.
`402`	Assinatura inativa. O proprietário deve regularizar a assinatura.
`404`	Vínculo inexistente no reconvite. Consulte a lista e o fluxo do evento.
`409`	Conflito de vínculo ou evento. Consulte a lista e o fluxo do evento.
`413`	Corpo maior que 1 MiB. Reduza o conteúdo da requisição.
`415`	Formato não suportado. Envie Content-Type: application/json.
`429`	Limite de requisições. Use espera exponencial e reconciliação.
`500`	Falha interna. Use espera exponencial e reconciliação.
`503`	Autenticação ou serviço temporariamente indisponível. Use espera exponencial, preserve externalId e idempotencyKey e consulte o estado antes de criar um novo evento.

O mecanismo atual limita a 120 solicitações por minuto por chave e IP. O controle é atômico e bloqueia solicitações quando não consegue validar o limite. Quando o serviço de validação está indisponível, a API retorna 503; aguarde antes de repetir. Paginação aceita no máximo 1.000 registros por chamada.

Não há cabeçalho genérico Idempotency-Key, endpoint por pessoa ou webhook de RH nesta interface. O discriminador das operações é o campo action no JSON.