Como medimos

Taxa de sucesso

É a parte das consultas que a plataforma entregou com sucesso, entre as que ela deveria entregar. Contamos como falha o erro do lado do servidor (os de classe 5xx: falha nossa ou da fonte de dados). Erro causado pelos dados enviados na consulta nunca conta como falha: uma placa inválida, um documento que não existe, falta de saldo ou um pedido mal formado são respostas corretas da plataforma.

Na prática: taxa = sucessos ÷ (sucessos + falhas do servidor). Usuários e chamadas de monitoramento interno ficam de fora.

As janelas de 24 horas e a de «ao vivo» usam o desfecho da consulta do cliente (entregue ou não entregue). As de 7 dias em diante usam o fechamento diário dos registros da plataforma. As duas fontes podem divergir em alguns décimos de ponto percentual. Nas consultas pagas com créditos, o fechamento diário pode sair um pouco abaixo do real.

A taxa por API é medida desde 18/09/2026. Antes disso mostramos só a latência daquela API, e o histórico geral da plataforma começa em 26/03/2026.

Latência

Mostramos duas medidas: p50 (a mediana: metade das consultas é mais rápida que isso) e p95 (95 de cada 100 consultas são mais rápidas que isso; mostra a cauda lenta que a média esconde). Não publicamos o p99, que fica instável com poucas consultas.

O tempo é medido no gateway da APIBrasil: inclui o tempo da fonte de dados, e não inclui a rede entre o seu sistema e a nossa. Por isso, o que o seu sistema mede pode ser maior.

Os valores são arredondados (dois algarismos significativos: 4,6 s, 350 ms) e acima de 30 segundos aparece «≥ 30 s».

Disponibilidade medida

É a parte das horas medidas em que a API não esteve indisponível, ou seja, em que a taxa de sucesso da hora ficou em 80 % ou mais. Só entram horas com volume suficiente de consultas; hora sem volume suficiente não conta nem a favor nem contra.

Esta medição por hora começou a ser guardada recentemente. Por isso o indicador só aparece quando a janela inteira já tem medição e uma cobertura mínima; até lá você vê «Coletando» e a data de início. Para a plataforma inteira, uma hora conta como indisponível quando metade ou mais das APIs medidas naquela hora está abaixo de 80 % (com pelo menos três APIs medidas).

Não confunda com a disponibilidade calculada por minutos de incidente: ela não é publicada enquanto o cadastro de incidentes não for completo.

Dias saudáveis

É o número de dias com taxa de sucesso de 95 % ou mais, entre os dias com volume suficiente para medir (por exemplo, «87 de 90»). Dias sem volume suficiente não entram na conta.

Incidentes

Mostramos dois tipos, sempre separados:

• Registrado: cadastrado pela nossa equipe, com início, fim, severidade (total, parcial ou degradação) e componente afetado. O texto é padronizado, por exemplo «Instabilidade em fonte de dados externa · API Gravame». Não publicamos a causa detalhada. Antes de agosto de 2026 o cadastro de incidentes é parcial.
• Detectado pela medição: identificado automaticamente pela medição por hora. Hora com taxa abaixo de 80 % é indisponível; entre 80 % e 95 %, instável. Sequências separadas por até uma hora são unidas. Publicamos indisponibilidade a partir de 1 hora seguida e instabilidade a partir de 2 horas.

O tempo médio de recuperação é a média da duração dos incidentes encerrados na janela. «Desde o último incidente» conta os dias inteiros desde o fim do mais recente. Você pode assinar o feed (Atom) de incidentes da plataforma ou de cada API.

Origem das falhas

No gráfico mensal, as colunas mostram as falhas em percentual das consultas, separadas por origem:

• APIBrasil: falha na nossa plataforma.
• Fonte de dados externa: a fonte consultada não respondeu ou respondeu com erro e repassamos o erro. Não nomeamos fornecedores.
• Sem classificação: falha em que a origem não foi registrada. Nunca redistribuímos esta parte entre as outras duas.

A classificação da origem existe desde 17/09/2026. Antes disso, quase toda falha aparece como «sem classificação».

Faixa de 90 dias

Cada barra é um dia: verde com taxa de 95 % ou mais, âmbar entre 80 % e 95 %, vermelho abaixo de 80 %. Cinza quer dizer que o volume do dia foi insuficiente (ou que não há dado), e cinza hachurado, que a taxa por API ainda não era medida naquele dia. Cada situação também tem ícone e texto na legenda, para não depender só da cor.

Janelas, ao vivo e horário

Na página de cada API você escolhe a janela: ao vivo, 24 horas, 7, 30 e 90 dias ou 12 meses. Dia e mês seguem o horário de Brasília (do começo ao fim do dia local).

Ao vivo é uma janela móvel de 15 minutos, calculada a cada minuto, mostrando a última hora. A página busca dados novos a cada 30 segundos, e a medição tem 2 minutos de atraso de propósito, para só usar minutos completos e para que a página não seja usada como termômetro em tempo real de um ataque. O horário da última medição aparece no topo de cada tela.

Se a medição atrasar ou a coleta falhar, a página avisa e deixa de afirmar que está tudo bem.

Comparação com o período anterior

Nos indicadores de 7, 30 e 90 dias mostramos a diferença para a janela imediatamente anterior, em seta e texto (por exemplo «▼ −300 ms vs. 30 dias anteriores»). Taxa maior é melhor; latência menor é melhor. A cor nunca é o único sinal.

Melhor horário para consultar

O mapa de calor mostra a mediana da latência p95 por dia da semana e hora do dia (horário de Brasília), nos últimos 30 dias. A escala de cores logo abaixo do mapa diz o que cada tom significa; célula só com contorno quer dizer que não há amostra suficiente. Ele só aparece quando já existem 14 dias de medição por hora e mostra a célula apenas quando há amostra suficiente.

Volume insuficiente

Com poucas consultas, uma taxa não quer dizer nada: uma única falha derrubaria o número, e uma hora sem falha não prova que a API está bem. Quando o volume de uma janela (minuto, hora, dia ou mês) fica abaixo de um mínimo, mostramos «volume insuficiente» no lugar do número. Isso não indica falha, e nunca pintamos essa situação de verde nem de vermelho.

Precisão dos números

Os números são publicados com uma precisão fixa, a mesma em qualquer volume de consultas:

• Taxa de sucesso de cada API: em passos de 0,1 ponto percentual (por exemplo, 99,9 %).
• Taxa de sucesso da plataforma inteira: em passos de 0,01 ponto percentual (por exemplo, 99,95 %).
• Latência: com dois algarismos significativos, em passos de 10 ms ou mais (por exemplo, 90 ms, 350 ms, 4,6 s). O teto é «≥ 30 s».

As taxas são truncadas, nunca arredondadas para cima: se houve qualquer falha, nunca aparece 100 %. Uma API com 99,98 % de sucesso aparece como 99,9 %.

No gráfico e na tabela mensais, as fatias de falha por origem (APIBrasil, fonte de dados externa e sem classificação) são arredondadas, enquanto a taxa é truncada. Por isso a soma das fatias pode não fechar exatamente com a taxa: a diferença para 100 % chega a cerca de 0,25 ponto percentual numa API e a cerca de 0,03 na plataforma. Com poucas falhas, uma API pode aparecer com 99,9 % de sucesso e 0,0 % em cada origem. Não é erro de cálculo: é o arredondamento de números muito pequenos.

Não publicamos a quantidade de consultas. As células com poucas chamadas (minuto, hora, dia ou mês) aparecem como «volume insuficiente», em vez de um número pouco confiável.

O que não mostramos

Para proteger clientes e a plataforma, esta página não publica: quantidade de consultas, clientes, fornecedores, endereços ou rotas internas, causa detalhada de incidentes, nem mensagens de erro. Só percentuais, tempos arredondados, estados e horários.

Dúvidas sobre os números? Fale com o suporte pelo site da APIBrasil.