Monitoramento de API que pega a resposta errada.

O seu endpoint de verificação de estado não detecta um fluxo de login avariado. A Uptimia faz login, chama a API e verifica as respostas — para que receba o passo que falhou, não um pedido de assistência.

Comece gratuitamente → Ver preços
Teste gratuito de 30 dias · até 50 monitores de API Não é necessário cartão de crédito Pronto para o GDPR
Intervalo mais rápido
60s
Confirmações
3
Sondas
171+
Países com sondas
70+

A requisição que voltou errada

Um fluxo de encomenda de cinco passos, executado por agendamento. O login, a consulta da encomenda e o total passam todos — a requisição seguinte não.

passo 1 Fazer login — obter o tokenO login é bem-sucedido; o token devolvido fica salvo em {{token}} equipe: tranquila
passos 2–3 Chamar a API com eleGET /orders obtém {{order_id}}; a encomenda tem de mostrar o total correto equipe: tranquila
passo 4 Falha ao adicionar a notaA asserção identifica a falha: a nota nunca chegou a ser criada equipe: tranquila
14:32 Confirmado noutra localização — e só então soa o alertaOutras localizações voltam a executar e confirmam; o alerta já indica o passo 4 alerta: com a causa
passo 4indicado no alerta
"O passo 4 falhou na verificação."14:32
É toda a investigação feita antes de abrir o notebook: o passo, a asserção e a confirmação de que não é uma sonda tendo uma má noite. A correção começa na requisição que falhou — não em "a API está indisponível".
passo com falha identificadoasserção exata citadaconfirmado a partir de outras localizaçõesstatus · tempos · cabeçalhos · valores — por passo
E com apenas um ping? O /health continua respondendo bem o tempo todo — um passo avariado no meio do fluxo nunca chega a tocar-lhe. O primeiro sinal é um cliente que não conseguiu concluir, seguido de uma caça aos registros para descobrir onde partiu. descoberto por um cliente

O que um ping nunca vê

Uma requisição que é bem-sucedida mas devolve dados errados continua sendo uma falha, e um passo avariado três requisições dentro do fluxo nunca chega a tocar no seu endpoint de verificação de estado. Aponte um monitor à sua própria API — ou às APIs de fornecedores de que depende, e saiba se a culpa é deles, não sua.

Códigos de status e cabeçalhosA resposta esperada, em cada passo
Valores na respostaQualquer campo, verificado passo a passo
Falhas no meio do fluxoO passo 3 falha — um ping nunca o vê
Deriva na respostaFormato errado, campos faltando
15 passos por cadeia o fluxo completo, executado de verdade
A autenticação falhaTokens expirados, logins rejeitados
Erros de TLS e de conexãoHandshakes e sockets recusados
Orçamento de tempo de respostaCada passo dentro do seu limiar
Os alertas identificam o passo e a asserção que falhou: uma requisição falhada, um valor errado na resposta, um campo faltando, um passo lento, um erro de conexão ou um login que deixou de funcionar. passo + asserção

Cadeias, asserções e tempos

O fluxo

Encadeie até 15 requisições

Cada passo pode extrair um valor da resposta — um token, um id de encomenda — para uma variável que os passos seguintes reutilizam como {{name}}. Um único monitor cobre o percurso desde o login até à limpeza final.

  • 6 métodos HTTP — GET, POST, PUT, PATCH, DELETE ou HEAD, em qualquer ordem
  • Extraia para variáveis — use-as nos passos seguintes como {{name}}
  • Cabeçalhos, corpo e tempo limite personalizados por passo — duplique um passo para construir depressa
Percorra o mesmo fluxo com um browser real →
POST/auth/login1 asserção
{{token}}extraído → passos seguintes
GET/orders2 asserções
{{order_id}}
GET/orders/{{order_id}}3 asserções
POST/orders/{{order_id}}/notes1 asserção
DEL/sessions/{{token}}limpeza
Cadeia bem-sucedida1.94 s
Um único monitor executa todo o percurso — do login à limpeza — até a cada minuto.
5 passos7 asserções2 variáveis
Um passo sem asserções passa mesmo assim quando a requisição é bem-sucedida — adicione verificações só onde importam. qualquer sucesso
Asserções

Verifique status, valores e tempos

Adicione as verificações que um passo tem de cumprir: um status exato, um orçamento de tempo de resposta, um valor no corpo da resposta, um cabeçalho ou texto na resposta. Quando uma falha, a execução mostra o que obteve — e Testar chama o endpoint real antes de salvar.

  • Status e tempo de resposta — o passo falha se o código estiver errado ou a resposta demorar demais
  • Valores dentro da resposta — aponte a um campo e exija que esteja presente e correto
  • Cabeçalhos e texto do corpo da resposta — exija um valor de cabeçalho, ou texto que tem de estar presente ou ausente
Vigie o texto de uma página, não só o status →
Testar200 · 191 ms
GET /orders/8842 · passo 3 — a resposta ao vivo, obtida de verdade antes de salvar.
{
  "id": 8842,
  "status": "paid",
  "total": 4210
}
o status é 200obteve 200
$.status é igual a "paid"obteve "paid"
resposta abaixo de 500 msobteve 191 ms
Extraído {{order_id}} = 8842 alimenta o passo seguinte — destacado na resposta ao vivo acima. = 8842
Tempos

DNS, TLS ou o seu próprio backend

"A API está lenta" nunca é a história toda. O tempo de cada passo é dividido em cinco fases — DNS, conexão, TLS, espera, recepção — para que veja qual o passo que está atrasando tudo e se a causa é a rede ou o seu backend.

  • Tempos em cinco fases por passo — DNS, conexão, TLS, espera, recepção
  • Gráfico de tempo de resposta por passo — empilhado, com marcadores de incidentes
  • Passo mais lento e execuções mais lentas em destaque na página de detalhe do monitor
Tempos fase a fase para páginas web →
Passo 4 — lento14:32:16
POST /orders/8842/notes · 1.389 ms no total, dividido em cinco fases.
dns18 ms
conexão31 ms
tls44 ms
espera1,284 ms
recepção12 ms
Rede — sem problemas
dns 18 · connect 31 · tls 44
93 ms
Backend — o atraso
demora antes do primeiro byte
1,284 ms
Passo mais lento e execuções mais lentas ficam na página do monitor — um gráfico empilhado por passo mostra quando começou o atraso. mais lento
Segredos

Chaves de API reais, sempre ocultas

Salve senhas, chaves de API e tokens como variáveis secretas: só de escrita, ocultas na leitura e removidas de URLs, cabeçalhos e excertos de resposta reproduzidos. Nada sensível fica no histórico de execuções.

  • Variáveis secretas só de escrita — ocultas sempre que são lidas
  • Removidas onde quer que sejam reproduzidas — URLs, cabeçalhos e excertos do corpo
  • Valores extraídos que correspondam a um segredo também nunca são reproduzidos
Monitore páginas atrás de um login →
API_KEYsegredo
••••••••••••••••só de escrita
Salvo uma vez, nunca mais mostrado — uma leitura devolve value:'' · has_value:true.
Cabeçalho do passo 1 — o que configura
Authorization: Bearer {{API_KEY}}
chave real injetada no momento do envio — só em memória, nunca salva
Histórico de execuções — o que fica salvo
Authorization: Bearer [redacted]
Os valores extraídos que coincidam com um segredo também não são mostrados — nada sensível chega ao histórico de execuções. ocultos

Encadeie os pedidos uma vez.Saiba sempre qual foi o passo que falhou.

Todos os passos, todas as asserções, todos os canais de alertas — grátis durante 30 dias, sem nenhum extra pago.

Comece gratuitamente →
30 dias grátis não é necessário cartão de crédito cancele quando quiser

Como funciona, passo a passo

Construa a cadeia, teste-a com a API em produção e a Uptimia executa-a por agendamento a partir da nossa rede — não precisa de instalar nada.

Passo 1construir

Encadeie as suas requisições

Adicione cada pedido pela ordem certa, defina cabeçalhos e corpo, e extraia para variáveis os valores de que os passos seguintes precisam.

Passo 1 · pedido
POST /auth/login
extrair $.token → {{token}}
Passo 2 · pedido
GET /orders
Passo 2testar

Defina asserções e teste

Adicione as verificações que cada passo tem de cumprir e depois Teste contra o endpoint real — resultados completos por passo, antes de salvar.

Asserções · passo 3
o status é 200$.status = "paid"
abaixo de 500 ms
Testar · 5/5 passos bem-sucedidos em 1,9 s
Passo 3a cada minuto

Executamos por agendamento

Uma sonda executa a cadeia toda numa única ida e volta, verifica cada asserção e salva os resultados por passo — as falhas são confirmadas a partir de outras localizações antes de alertar.

Execução OK — 5/5 passos
14:31 · 1,8 s · todas as asserções passaram
a tempo
Execução falhada — passo 4
14:32 · esperava 201, obteve 500
alertando

Também incluído

Slack, PagerDuty, SMS e mais 9

Um alerta de API indica o passo que falhou e a causa, entregue nos mesmos contatos que qualquer monitor da Uptimia usa — e-mail, SMS, Slack, Teams, Discord, PagerDuty, webhooks e mais.

passo 3 · $.status: esperava "paid", obteve "pending" → Slack · E-mail · PagerDuty

Confirmado a partir de outras localizações antes de alertar

Uma execução falhada é tentada novamente primeiro a partir de outras localizações disponíveis.

repetido noutro local · confirmado antes de abrir

Duplique um passo

Construa uma cadeia longa rapidamente — copie um pedido e ajuste-o.

passo 3 → duplicar → passo 4

Exportação de RCA do incidente

Um incidente encerrado mantém o detalhe ao nível de cada passo — exporte-o.

RCAPDFHTML

Tempo limite, cabeçalhos e corpo por pedido

Dê a cada pedido o seu próprio tempo limite, cabeçalhos e corpo.

tempo limite 10 s · 20 cabeçalhos · corpo de 64 KB

Todos os tipos de monitor numa só conta

Os seus monitores de API integram-se com os monitores de disponibilidade, SSL, heartbeat e DNS — usam os mesmos contatos, grupos e papéis.

Checkout order flowAPI www.caldmont.comUPTIME db-backup · nightlyHEARTBEAT

O que é o monitoramento de API?

O monitoramento de API é um serviço automatizado que executa por agendamento uma sequência real de pedidos HTTP contra a sua API REST ou endpoint JSON e alerta quando um passo devolve o estado errado, os dados errados ou demora demasiado tempo. Vigia o fluxo por detrás de um endpoint, não só se o servidor respondeu.

Enquanto tudo funciona

Como funciona o monitoramento de API?

Uptimia
executa a cadeia
5 passos · por agendamento
A sua API
todas as verificações passam

Uma sonda executa cada passo numa única ida e volta, avalia cada asserção e salva os resultados por passo como histórico de execuções.

Quando uma verificação falha

Primeiro confirma, depois alerta

A sua API
passo 4 · falhou
nova execução · outras localizações
Uptimia
abre o incidente

o passo 4 falhou na verificação → o incidente é aberto, o alerta indica o passo

As verificações

O que verifica um monitor de API?

Por predefinição, um passo passa com uma resposta bem-sucedida. Adicione asserções e a execução tem de as comprovar — um estado exato, um orçamento de tempo de resposta, um valor na resposta, um cabeçalho ou texto no corpo.

Ferramenta gratuita: verifique o estado e os cabeçalhos de qualquer endpoint →
VerificaçãoO que comprovaExemplo
Código de statuso endpoint respondeu como esperadoé 201 · é um de 200/204 · qualquer 2xx
Tempo de respostao passo é suficientemente rápidoabaixo de 500 ms
Corpo JSONa resposta contém os dados certos$.status é igual a "paid"
Cabeçalhoo content type ou a regra de cache corretosContent-Type contém json
Texto do corpoum marcador está presente ou ausentecontém "order created"

Perguntas frequentes

01O que é o monitoramento de API?+
Um serviço automatizado que executa por agendamento uma sequência real de pedidos HTTP contra a sua API e verifica as respostas. Um único monitor da Uptimia encadeia até 15 pedidos e alerta quando um passo devolve o estado errado, os dados errados ou demora demasiado tempo. Também é conhecido como monitoramento sintético de API ou verificação de estado automatizada da API.
02Em que é que isto é diferente de um simples ping de disponibilidade?+
Um ping diz a você que o servidor respondeu. O monitoramento de API executa o fluxo completo e verifica a própria resposta — código de status, tempo de resposta, cabeçalhos e os valores no JSON. Um 200 que devolve dados errados é capturado aqui, mas é invisível para um simples ping.
03Com que frequência a Uptimia executa minha verificação?+
Por predefinição a cada 5 minutos, e com uma frequência até de um minuto — a verificação de agendamento corre a cada minuto, por isso um minuto é o limite mínimo. Também pode reduzir a frequência de qualquer monitor para endpoints de menor prioridade.
04Quantos passos pode ter um monitor?+
Até 15 pedidos HTTP numa única cadeia, cada um com até 20 cabeçalhos, 15 asserções e 10 extrações de valores. O tempo limite por passo vai de 1 a 60 segundos, e a cadeia completa tem um orçamento de execução de 90 segundos.
05Executa JavaScript ou renderiza a página como um browser?+
Não. O monitoramento de API envia pedidos HTTP simples — sem browser headless, sem JavaScript, sem capturas de tela. Para percorrer um fluxo renderizado com um browser real, use o monitoramento de transações da Uptimia; o monitoramento de API é a ferramenta mais leve e rápida para a própria API.
06Posso verificar um valor dentro da resposta JSON?+
Sim. Aponte um seletor JSONPath ao campo e afirme que existe, é igual a, contém ou é um de um conjunto de valores. Também pode extrair um valor para uma variável e reutilizá-lo nos passos seguintes como {{name}}. O suporte a JSONPath é um subconjunto focado nas respostas de API típicas.
07Suportam GraphQL ou WebSockets?+
O GraphQL funciona como um simples POST HTTP — envie a query no corpo e verifique o JSON devolvido — mas não existe um construtor específico para GraphQL. WebSockets não são suportados; o monitoramento de API cobre pedido/resposta sobre HTTP (GET, POST, PUT, PATCH, DELETE, HEAD).
08Posso importar um comando cURL ou partir de uma receita?+
Não nesta versão. Cada passo é construído no editor — método, URL, cabeçalhos, corpo, asserções, extrações — e pode duplicar um passo para avançar mais depressa. A importação de cURL e uma biblioteca de receitas ainda não fazem parte do monitoramento de API.
09Como evitam falsos alarmes?+
Uma execução falhada é tentada novamente a partir de outras localizações antes de o incidente ser aberto — por predefinição, três localizações têm de concordar (a original mais duas novas tentativas) antes de o alerta ser acionado. Já a recuperação é rápida: uma única execução bem-sucedida encerra o incidente e envia o aviso de recuperação.
10As minhas chaves de API estão seguras numa verificação?+
Sim. Salve as credenciais como variáveis secretas: só de escrita, ocultas na leitura e omitidas de URLs, cabeçalhos e excertos de resposta apresentados — nada sensível chega ao histórico de execuções.
11O monitoramento de API é um extra pago?+
Não. Todos os planos incluem monitoramento de API a par do monitoramento de disponibilidade, SSL, transações, DNS e heartbeat — nunca como um extra pago. Até o plano gratuito inclui um monitor de API; os planos diferem apenas na quantidade incluída, e o teste gratuito de 30 dias inclui até 50, não é necessário cartão de crédito.

Comece hoje a monitorar a sua API.

Construa a cadeia, valide-a no endpoint em produção — e da próxima vez que um passo falhar, o alerta já lhe diz qual foi.

Comece gratuitamente →
Teste gratuito de 30 dias Até 50 monitores de API Não é necessário cartão de crédito Pronto para o GDPR
O monitoramento de API junta-se ao monitoramento de disponibilidade, SSL, velocidade, transações, DNS e heartbeat, tudo numa única conta Uptimia.