Limites e erros

Dois tetos, dois cabeçalhos, e o que cada código significa.

Pegue uma chave de sandboxe os exemplos passam a mostrar a sua.

São dois limites independentes, e cada um tem o seu cabeçalho em toda resposta. Confundir os dois é tratar "espere um segundo" como "fale com o financeiro".

http
X-RateLimit-Limit: 5        # rajada, por segundo
X-RateLimit-Remaining: 4
X-Quota-Limit: 500          # cota do mês
X-Quota-Remaining: 487
CódigoO que aconteceuO que fazer

401

Chave ausente, inválida ou revogada

Conferir o cabeçalho e a chave

402

A cota do mês acabou

Subir de plano — a cota volta no dia 1º

404

CNPJ não existe na base

Não repetir: a resposta não vai mudar

429

Rajada acima do teto por segundo

Esperar o Retry-After e repetir

503

A contagem não terminou no tempo

Usar o has_next da listagem