Stats

Salud de infraestructura de un motor o endpoint en la última hora. No está limitado a su cuenta o tenant.

El endpoint Stats devuelve una instantánea de salud de infraestructura para un motor de API o una ruta concreta. Las métricas se agregan en toda la plataforma en una ventana de una hora. No son el uso de su cuenta o tenant. No hay series temporales. Use Uso para la cuota de su cuenta.

Este endpoint es gratuito. Nunca consume créditos.

Estas son stats de infraestructura de la plataforma, no stats de su cuenta o tenant. Todos los llamantes autenticados ven la misma instantánea. Para créditos restantes y límites de tasa, use Uso.

Parámetros de consulta

Indique al menos engine o path.

engine (string): familia de API a comprobar, por ejemplo linkedin o google.
path (string): endpoint concreto a comprobar, por ejemplo /v1/linkedin/profile-info. Si también envía engine, use un endpoint de esa API.

Solicitud

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 salud

operational: tasa de éxito igual o superior al 99%.
degraded: tasa de éxito del 90% al 99%.
down: tasa de éxito inferior al 90%.

Campos de respuesta

Campo	Tipo	Descripción
`engine`	`string`	Identificador del motor según el catálogo (por ejemplo `linkedin`)
`path`	`string \| null`	Filtro de ruta normalizado, o `null` si consulta solo por motor
`health`	`string`	`operational`, `degraded` o `down` en la última hora
`success_rate`	`number`	Tasa de éxito de la última hora. Solo los HTTP 5xx cuentan como error. Las ventanas de bajo volumen se suavizan.
`avg_response_time_ms`	`integer`	Tiempo de respuesta medio en milisegundos. Se excluyen duraciones superiores a 60 segundos.
`window`	`string`	Ventana de agregación. Siempre `1h`.

La respuesta no incluye el volumen de solicitudes, el recuento bruto de errores ni ningún dato a nivel de cuenta o tenant.

Ejemplo de respuesta

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

Errores

Código	Descripción
`400`	Faltan `engine` y `path`, valor no válido, o ruta que no coincide con `engine`
`401`	Clave API ausente o no válida
`404`	Motor desconocido (no está en el catálogo de la API)
`503`	Los datos de estado no están disponibles temporalmente

Véase también: Uso para la cuota de su cuenta (ámbito tenant), Códigos de estado para las reglas de facturación HTTP, y Gestión de errores para errores de integración.