uptimescout
Obtenir une clé API

REST / MCP / SDK

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é.

Démarrage rapide

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/servicesRechercher dans le catalogue de services et parcourir ses pages.
GET /v1/statusConsulter l’état enregistré actuel d’un service.
GET /v1/statusesConsulter l’état de plusieurs services dans une seule requête.
GET /v1/summaryRésumer les signaux observés pour une région ou des services sélectionnés.
GET /v1/historyConsulter les observations enregistrées au fil du temps et parcourir les pages.
GET /v1/statsCalculer les proportions d’échantillons de signaux enregistrés, plutôt que la disponibilité mesurée.
GET /v1/incidentsLister 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.

Tous les services

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.

Les paiements, renouvellements, changements de formule et la gestion des licences sont pris en charge par Evelode.com. Le quota de requêtes est réinitialisé au renouvellement de la licence ou en cas de changement de formule. Il n’est pas réinitialisé au début du mois civil. Les formules annuelles regroupent douze quotas mensuels en un seul pool de requêtes pour toute la durée de la licence. L’historique s’accumule à partir du lancement de la collecte. La formule Free n’entraîne aucun paiement récurrent.

Tarifs

Connecter un assistant IA

Ajoutez l’URL du serveur dans votre assistant, choisissez OAuth, puis connectez-vous avec Evelode ou saisissez votre clé de licence sur l’écran de connexion. Aucun secret client n’est nécessaire.

Connecter UptimeScout

https://mcp.uptimescout.com
Authorization: Bearer YOUR_EVELODE_LICENSE_KEY

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.

Exemple tiré des observations enregistrées

{
  "available_regions": [
    "AE",
    "AR",
    "AT",
    "AU",
    "AZ",
    "BD",
    "BE",
    "BG",
    "BH",
    "BR",
    "CA",
    "CH",
    "CL",
    "CO",
    "CR",
    "CZ",
    "DE",
    "DK",
    "DO",
    "DZ",
    "EC",
    "EG",
    "ES",
    "FI",
    "FR",
    "GB",
    "GR",
    "GT",
    "HK",
    "HR",
    "HU",
    "ID",
    "IE",
    "IL",
    "IN",
    "IT",
    "JO",
    "JP",
    "KE",
    "KR",
    "MA",
    "MX",
    "MY",
    "NG",
    "NL",
    "NO",
    "NZ",
    "PA",
    "PE",
    "PH",
    "PK",
    "PL",
    "PR",
    "PT",
    "PY",
    "RO",
    "RS",
    "RU",
    "SA",
    "SE",
    "SG",
    "SK",
    "TH",
    "TN",
    "TR",
    "TW",
    "UA",
    "US",
    "UY",
    "VE",
    "VN",
    "ZA"
  ],
  "data_type": "availability_observations",
  "generated_at": "2026-11-18T18:55:18.288363Z",
  "region": "US",
  "service": {
    "age_seconds": 16,
    "category": "it",
    "description": "Plateforme de d\u00e9p\u00f4ts Git, de collaboration sur le code, de suivi des probl\u00e8mes et de livraison de logiciels.",
    "description_language": "fr",
    "id": "github",
    "logo_kind": "brand",
    "logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
    "name": "GitHub",
    "observed_at": "2026-11-18T18:55:01.987427Z",
    "regions": [
      "US"
    ],
    "scope": "regional",
    "signal": "reported_availability",
    "stale": false,
    "status": "outage"
  },
  "stale_after_seconds": 600,
  "status": "ok"
}

Aperçu rapide

Chargement des observations enregistrées

Évolution des signaux

Chaque intervalle affiche le signal observé le plus fréquent. En cas d’égalité, le dernier état observé parmi ceux à égalité l’emporte. Sélectionnez une colonne pour afficher la répartition complète.