Stats

Saúde de infraestrutura de um motor ou endpoint na última hora. Não está limitado à sua conta ou tenant.

O endpoint Stats devolve um instantâneo de saúde de infraestrutura para um motor de API ou um caminho específico. As métricas são agregadas em toda a plataforma numa janela de uma hora. Não são o uso da sua conta ou tenant. Não há série temporal. Use Uso para a cota da sua conta.

Este endpoint é gratuito. Nunca consome créditos.

Estas são stats de infraestrutura da plataforma, não stats da sua conta ou tenant. Todos os chamadores autenticados veem o mesmo instantâneo. Para créditos restantes e limites de taxa, use Uso.

Parâmetros de consulta

Indique pelo menos engine ou path.

engine (string): família de API a verificar, por exemplo linkedin ou google.
path (string): endpoint concreto a verificar, por exemplo /v1/linkedin/profile-info. Se também enviar engine, use um endpoint dessa API.

Requisição

curl "https://api.huntapi.com/v1/stats?engine=linkedin" \
  -H "x-api-key: YOUR_API_KEY"

curl "https://api.huntapi.com/v1/stats?path=/v1/linkedin/profile-info" \
  -H "x-api-key: YOUR_API_KEY"

Valores de saúde

operational: taxa de sucesso igual ou superior a 99%.
degraded: taxa de sucesso de 90% a 99%.
down: taxa de sucesso inferior a 90%.

Campos de resposta

Campo	Tipo	Descrição
`engine`	`string`	Identificador do motor no catálogo (por exemplo `linkedin`)
`path`	`string \| null`	Filtro de caminho normalizado, ou `null` quando consulta só por motor
`health`	`string`	`operational`, `degraded` ou `down` na última hora
`success_rate`	`number`	Taxa de sucesso da última hora. Apenas HTTP 5xx conta como falha. Janelas de baixo volume são suavizadas.
`avg_response_time_ms`	`integer`	Tempo médio de resposta em milissegundos. Durações acima de 60 segundos são excluídas.
`window`	`string`	Janela de agregação. Sempre `1h`.

A resposta não inclui o volume de pedidos, a contagem bruta de erros nem quaisquer dados ao nível da conta ou do tenant.

Exemplo de resposta

{
  "engine": "linkedin",
  "path": "/v1/linkedin/profile-info",
  "health": "operational",
  "success_rate": 99.412,
  "avg_response_time_ms": 840,
  "window": "1h"
}

Erros

Código	Descrição
`400`	Faltam `engine` e `path`, valor inválido, ou caminho que não corresponde a `engine`
`401`	Chave de API em falta ou inválida
`404`	Motor desconhecido (não está no catálogo da API)
`503`	Dados de estado temporariamente indisponíveis

Veja também: Uso para a cota da sua conta (âmbito tenant), Códigos de estado para as regras de faturação HTTP, e Tratamento de erros para erros de integração.