# Intégrer une API de disponibilité des services avec UptimeScout



URL: https://uptimescout.com/fr/blog/availability-api-integration/



Créez un panneau de disponibilité qui laisse les horodatages et l’incertitude visibles au lieu de réduire chaque réponse à un point de couleur.



## Découvrez les identifiants de service avant d’interroger l’API



Commencez par le point de terminaison des services pour trouver l’identifiant utilisé par UptimeScout. Le nom de marque, lisible par une personne, ne correspond pas toujours à l’identifiant de l’API. Conservez l’ID et la région dans la configuration de votre application afin que les requêtes de statut et d’historique portent sur le même service.

Procurez-vous une licence éligible auprès d’Evelode et conservez-la dans un secret côté serveur ou une variable d’environnement. N’intégrez pas une clé payante dans du JavaScript côté navigateur, un dépôt public, une capture d’écran ou une URL.



## Envoyez une requête de statut authentifiée



Définissez EVELODE_LICENSE_KEY dans votre propre environnement avant d’exécuter l’exemple. Cet exemple demande les observations GitHub pour US ; il s’agit d’un modèle de requête, et non d’une affirmation sur l’état actuel de GitHub.



```sh

curl -G https://api.uptimescout.com/v1/status \
  --data-urlencode "service=github" \
  --data-urlencode "region=US" \
  -H "Authorization: Bearer $EVELODE_LICENSE_KEY"

```



## Interprétez la réponse avant de l’afficher



Une réponse de transport réussie et le signal de disponibilité du service sont deux niveaux distincts. Vérifiez d’abord le statut HTTP et la structure de la réponse. Examinez ensuite service.status, service.observed_at et service.stale. Laissez unknown et les observations obsolètes visibles au lieu de les traiter implicitement comme operational.

Enregistrez la région avec l’heure de l’observation. Si votre interface s’actualise toutes les minutes, indiquez séparément l’heure de l’observation et celle à laquelle votre application a récupéré la réponse. Une réponse HTTP récente peut décrire une observation plus ancienne.



## Anticipez le volume de requêtes et gérez les limites



Si cela convient à votre processus, utilisez le statut par lot et vérifiez la taille maximale des lots prévue par l’offre choisie. Le quota de requêtes et les requêtes par minute sont deux limites différentes. Les accès REST, SDK et MCP partagent le même décompte de requêtes sous licence.

En cas de HTTP 429, respectez Retry-After et évitez une rafale de nouvelles tentatives immédiates. Utilisez un nombre limité de tentatives, avec un délai croissant pour les échecs temporaires ; ne réessayez pas indéfiniment en cas d’erreur d’authentification ou de paramètre invalide. Le renouvellement et les changements d’offre mettent à jour le quota associé à la licence ; il n’y a pas de réinitialisation au premier jour du mois civil.



## Testez les cas incertains avant le déploiement



Testez un service connu, un ID inconnu, une clé manquante, des paramètres invalides et une observation obsolète ou manquante. Vérifiez que votre interface présente des messages utiles dans chacun de ces cas. N’exposez pas le diagnostic complet dans des journaux publics s’il contient des identifiants ou des informations de compte.

La documentation de l’API présente les sept méthodes publiques et le schéma OpenAPI. jsonscraper propose des liens vers les SDK Python, Node.js, PHP, Go, Java et .NET. Une bibliothèque cliente simplifie le transport, mais votre application doit toujours définir comment traiter l’incertitude.



## Ressources

https://uptimescout.com/fr/docs/

https://uptimescout.com/fr/methodology/

https://uptimescout.com/fr/contacts/
