# Documentation de l’API UptimeScout

État des services, signaux régionaux et historique via REST, des SDK et MCP. Créez des tableaux de bord et donnez aux assistants IA un contexte clair sur la disponibilité.

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

## REST

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

## Méthodes disponibles

- `GET /v1/services`: Rechercher dans le catalogue de services et parcourir ses pages.

- `GET /v1/status`: Consulter l’état enregistré actuel d’un service.

- `GET /v1/statuses`: Consulter l’état de plusieurs services dans une seule requête.

- `GET /v1/summary`: Résumer les signaux observés pour une région ou des services sélectionnés.

- `GET /v1/history`: Consulter les observations enregistrées au fil du temps et parcourir les pages.

- `GET /v1/stats`: Calculer les proportions d’échantillons de signaux enregistrés, plutôt que la disponibilité mesurée.

- `GET /v1/incidents`: Lister les services présentant des signaux de perturbation accrue ; il ne s’agit pas d’incidents mondiaux confirmés.

## Fonctionnement des données

UptimeScout stocke les observations régionales en arrière-plan. Chaque réponse comprend une heure d’observation et des informations sur sa fraîcheur. Un même service peut présenter des signaux différents selon les régions.

Un signal de fonctionnement normal signifie qu’aucune perturbation accrue n’a été observée dans cet échantillon enregistré. Les signaux de perturbation accrue ou de panne décrivent les conditions observées, sans confirmer un incident mondial. Les observations manquantes ou obsolètes sont considérées comme inconnues. Les proportions des échantillons ne correspondent ni à des pourcentages de disponibilité mesurée ni à un SLA.

L’interface s’actualise chaque minute. Consultez l’horodatage de l’observation et sa fraîcheur pour évaluer l’actualité de l’état de chaque service.

La langue détermine la présentation des informations ; la région d’observation détermine le pays décrit par les données. Vous pouvez les modifier indépendamment. Une page traduite n’implique pas automatiquement que les observations proviennent d’un pays particulier.

## Licence et limites de requêtes

Utilisez votre clé de licence Evelode comme jeton Bearer. Conservez-la sur votre serveur, à l’écart du code exécuté dans le navigateur et des dépôts publics. Seules les requêtes de données sous licence qui aboutissent sont déduites de votre quota. Le renouvellement d’une licence ou le changement de forfait ouvre un nouveau quota ; les mois calendaires ne le réinitialisent pas. Le quota annuel correspond à 12 fois le quota d’une période de licence et constitue un seul pool pour toute la durée de la licence annuelle.

## Connecter un assistant IA

Connectez un client MCP Streamable HTTP au point de terminaison ci-dessous et fournissez votre clé de licence dans l’en-tête Authorization. Sept outils en lecture seule donnent accès aux états des services, aux signaux régionaux et à l’historique. Les mêmes limites de licence s’appliquent.

https://mcp.uptimescout.com

## Gestion des réponses

Vérifiez le code HTTP avant de lire les données : 400 indique des paramètres non valides, 401 ou 403 un problème d’authentification ou de licence, 409 un changement des droits associés à la licence pendant une requête, 429 une limite de requêtes ou de débit, et 503 une indisponibilité temporaire. Respectez les délais avant nouvelle tentative et évitez les tentatives répétées à intervalles rapprochés.

OpenAPI: https://uptimescout.com/openapi.json
