Guia de integração
Limites e retentativas
Clientes devem limitar sua taxa de chamadas, respeitar os headers de rate limit e usar espera progressiva em falhas temporárias.
Exemplo
HTTP/1.1 429 Too Many Requests
Retry-After: 30
RateLimit-Limit: <LIMITE>
RateLimit-Remaining: 0
RateLimit-Reset: <EPOCH>
Content-Type: application/problem+jsonResposta 429
Quando o limite é excedido, a API retorna 429, code: limite_excedido e o header Retry-After em segundos. Aguarde pelo menos esse período antes de repetir.
Headers informativos
As respostas incluem RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Monitore-os para evitar exceder os limites.
Valores propostos
O contrato propõe 600 requisições de leitura por minuto e 120 de escrita por minuto, por credencial. Esses números aguardam confirmação operacional da Weesy e devem ser tratados como provisórios.
Retentativas
Aplique backoff exponencial com jitter para 429 e falhas 503; limite o número de tentativas. Não repita automaticamente erros de validação ou conflitos sem corrigir ou consultar o recurso. Para criação de documento, preserve o mesmo idIntegracao.
Observação: Os limites numéricos ainda são proposta. Consulte o header Retry-After da resposta real e não codifique o valor provisório como garantia de serviço.