Ir para o conteúdo
Rudra Analyzer

Testador de endpoints de API

Envie uma solicitação do nosso servidor para um endpoint de API público e veja o código de status HTTP retornado, quanto tempo levou e se conta como sucesso. É uma forma rápida de confirmar que um endpoint está no ar e acessível pela internet.

Um endereço público, por exemplo https://api.example.com/v1/status. Não coloque dados secretos na URL: ela é salva junto com o resultado.

Cabeçalhos (opcional)

Os cabeçalhos são enviados ao endpoint, mas não são salvos. Se você enviar um corpo, adicione um cabeçalho Content-Type, como application/json.

O que é verificado

O que esta ferramenta verifica

  • Código de status

    O status HTTP que o endpoint retorna, depois de seguir até 5 redirecionamentos.

  • Tempo de resposta

    O tempo total de ida e volta a partir do nosso servidor, em milissegundos, incluindo a consulta de DNS, o estabelecimento da conexão e eventuais redirecionamentos.

  • Sucesso ou falha

    Uma solicitação tem sucesso quando o status final é menor que 400. Tempos esgotados (após 15 segundos), falhas de conexão e endereços bloqueados aparecem como erros.

Como a verificação funciona

Nosso servidor envia a solicitação com o método, os cabeçalhos e o corpo que você informar. O corpo é enviado exatamente como digitado, então adicione um cabeçalho Content-Type se a API espera JSON ou dados de formulário. O corpo da resposta não é exibido nem guardado.

Por segurança, só é possível testar endereços públicos da internet. Endereços em redes privadas (localhost, 10.x.x.x, 192.168.x.x, serviços de metadados de nuvem e similares) são bloqueados, e cada redirecionamento é verificado da mesma forma.

Você precisa de uma conta gratuita para usar o testador, e as solicitações têm limite por rede. Salvamos na sua conta a URL do endpoint, o método, o código de status, o tempo de resposta e eventuais erros; os cabeçalhos e o corpo não são salvos.

As evidências que você verá

O código de status final após os redirecionamentos, o tempo total de resposta em milissegundos medido a partir do nosso servidor, se ele conta como sucesso e a mensagem de erro quando não houve resposta.

O que esta ferramenta não verifica

  • O conteúdo da resposta

    O corpo não é mostrado, interpretado nem validado em relação a um schema.

  • Carga e confiabilidade

    Uma requisição por teste a partir de um único local - não é monitoramento de disponibilidade nem teste de carga.

  • Segurança da API

    Ela não testa autenticação, autorização nem o tratamento de entradas em busca de vulnerabilidades.

  • APIs privadas ou locais

    Endereços em redes privadas e localhost são bloqueados de propósito.

Problemas comuns que encontramos

  • 401 ou 403

    O endpoint exige autenticação, ou a chave ou o token enviado não tem permissão.

  • 404 Not Found

    Um caminho errado, a falta de um prefixo de versão como /v1 ou uma barra no final que a API não espera.

  • 405 Method Not Allowed

    O endpoint existe, mas não aceita este método, por exemplo um POST para um recurso somente leitura.

  • 400 ou 415

    O corpo está malformado, ou o cabeçalho Content-Type está ausente ou incorreto.

  • 429 Too Many Requests

    O limite de solicitações da própria API foi atingido.

  • Erros 5xx e tempos esgotados

    A API está fora do ar, sobrecarregada ou levando mais de 15 segundos para responder.

Como corrigi-los

  1. Envie as credenciais corretas

    Adicione um cabeçalho Authorization no formato indicado na documentação da API, por exemplo Authorization: Bearer seguido do seu token. Use uma chave de teste em vez de um segredo de produção.

  2. Compare o caminho com a documentação

    Compare a URL com a referência da API, incluindo prefixos de versão, barras no final e parâmetros de consulta.

  3. Combine o corpo com o Content-Type

    Para JSON, envie um JSON válido e o cabeçalho Content-Type: application/json.

  4. Investigue respostas lentas

    Tempos de resposta de vários segundos geralmente indicam consultas lentas ao banco de dados, inicializações a frio em hospedagem serverless ou um servidor longe da nossa localização.

Respostas para você

Perguntas frequentes

O que a verificação cobre, o que ela não pode dizer e quanto custa o relatório.

Por que preciso de uma conta?

A solicitação é enviada do nosso servidor para um endereço que você escolhe. Exigir uma conta gratuita e limitar as solicitações impede que o testador seja usado para enviar tráfego anônimo aos servidores de outras pessoas.

Posso testar localhost ou uma API interna?

Não. Endereços privados e internos são bloqueados de propósito, para que o testador não possa ser usado para acessar nossa própria rede interna. Para testar uma API local, use uma ferramenta que rode no seu próprio computador.

Por que não consigo ver o corpo da resposta?

O testador informa se o endpoint está acessível e com que rapidez ele responde. Ele não exibe nem guarda o conteúdo da resposta.

Minhas chaves de API são armazenadas?

Os cabeçalhos e o corpo da solicitação são enviados ao endpoint, mas não são salvos. A URL do endpoint é salva com o resultado, então não coloque dados secretos na query string da URL.

Por que o tempo de resposta é diferente do que vejo localmente?

Ele é medido a partir do nosso servidor, não do seu computador, então a distância, as rotas e o estabelecimento da conexão são diferentes. É mais útil para comparar um endpoint com ele mesmo ao longo do tempo.

Posso usá-lo para teste de carga?

Não. Ele envia uma única solicitação por vez e tem limite de uso. Use uma ferramenta própria para teste de carga, e apenas em servidores que você tem permissão para testar.