Aller au contenu principal
État du réseau
Se connecter
Piloterr
Retour à la bibliothèque

API 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. Activé par compte : HTTP 403 signifie contacter le support pour l'activer.

ActifGratuitGET/v2/stats
Essayer l'endpoint gratuitementPiloterr

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

PrésentationLink to Présentation

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 le point d'accès Usage pour le quota de votre compte Piloterr.

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

API Stats est activé par compte. Un HTTP 403 signifie qu'il n'est pas actif sur votre compte. Contactez le support pour l'activer.

Démarrage rapideLink to Démarrage rapide

GET https://api.piloterr.com/v2/stats?engine=website

GET https://api.piloterr.com/v2/stats?path=/v2/website/crawler

L'authentification s'effectue via l'en-tête x-api-key.

ParamètresLink to Paramètres

Fournissez au moins engine ou path.

Paramètre Type Requis Description
engine string non Famille d'API à vérifier, par exemple website.
path string non Point d'accès précis à vérifier, par exemple /v2/website/crawler. Si vous passez aussi engine, utilisez un point d'accès de cette API.
x-api-key string oui Votre clé API privée Piloterr

Valeurs de santéLink to 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éponseLink to Champs de réponse

Champ Type Description
engine string Identifiant du moteur issu du catalogue (par exemple website)
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.

ErreursLink to Erreurs

Code Description
400 engine et path absents, valeur invalide, ou chemin qui ne correspond pas à engine
401 Clé API absente ou invalide
403 API Stats n'est pas activé pour ce compte. Contactez le support pour l'activer.
404 Moteur inconnu (absent du catalogue API)
503 Données de statut temporairement indisponibles

NotesLink to Notes

  • 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é.
  • API Stats est activé par compte. Un HTTP 403 signifie qu'il n'est pas actif sur votre compte. Contactez le support pour l'activer.
  • Fournissez au moins engine ou path. Une requête sans les deux retourne 400.
  • Utilisez Usage (/v2/usage) pour vos crédits restants et limites de débit.

Cas d'usage principauxLink to Cas d'usage principaux

  • Bloquer un job en lot lorsque le moteur est degraded ou down
  • Afficher un badge de santé à côté d'un point d'accès
  • Alerter lorsque success_rate passe sous votre seuil

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus
Commencer gratuitement (+500 crédits)PiloterrParler à un expert