Stats

Santé d'infrastructure d'un moteur ou d'un point d'accès sur la dernière heure. Non limité à votre compte ou tenant.

Le point d'accès Stats renvoie un instantané de santé d'infrastructure pour un moteur API ou un chemin précis. Les métriques sont agrégées sur toute la plateforme, sur une fenêtre d'une heure. Ce n'est pas l'usage de votre compte ou tenant. Il n'y a pas de série temporelle. Utilisez Utilisation pour le quota de votre compte.

Ce point d'accès est gratuit. Il ne consomme jamais de crédit.

Ce sont les stats d'infrastructure de la plateforme, pas les stats de votre compte ou tenant. Tous les appelants authentifiés voient le même instantané. Pour les crédits restants et les limites de débit, utilisez Utilisation.

Paramètres de requête

Fournissez au moins engine ou path.

engine (string) : famille d'API à vérifier, par exemple linkedin ou google.
path (string) : point d'accès précis à vérifier, par exemple /v1/linkedin/profile-info. Si vous passez aussi engine, utilisez un point d'accès de cette API.

Requête

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"

Valeurs de santé

operational : taux de succès supérieur ou égal à 99 %.
degraded : taux de succès de 90 % à 99 %.
down : taux de succès inférieur à 90 %.

Champs de réponse

Champ	Type	Description
`engine`	`string`	Identifiant du moteur issu du catalogue (par exemple `linkedin`)
`path`	`string \| null`	Filtre de chemin normalisé, ou `null` si vous interrogez uniquement par moteur
`health`	`string`	`operational`, `degraded` ou `down` sur la dernière heure
`success_rate`	`number`	Taux de succès sur la dernière heure. Seuls les HTTP 5xx comptent comme échec. Les fenêtres à faible volume sont lissées.
`avg_response_time_ms`	`integer`	Temps de réponse moyen en millisecondes. Les durées au-delà de 60 secondes sont exclues.
`window`	`string`	Fenêtre d'agrégation. Toujours `1h`.

La réponse n'inclut ni le volume de requêtes, ni le nombre brut d'erreurs, ni aucune donnée au niveau du compte ou du tenant.

Exemple de réponse

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

Erreurs

Code	Description
`400`	`engine` et `path` absents, valeur invalide, ou chemin qui ne correspond pas à `engine`
`401`	Clé API absente ou invalide
`404`	Moteur inconnu (absent du catalogue API)
`503`	Données de statut temporairement indisponibles

Voir aussi : Utilisation pour le quota de votre compte (périmètre tenant), Codes de statut pour les règles de facturation HTTP, et Gestion des erreurs pour les erreurs d'intégration.