REST / MCP / SDK
UptimeScout API-documentatie
Servicestatus, regionale signalen en geschiedenis via REST, SDK's en MCP. Bouw dashboards en geef AI-assistenten duidelijke context over beschikbaarheid.
Snel aan de slag
curl -G https://api.uptimescout.com/v1/status \ --data-urlencode "service=github" \ --data-urlencode "region=US" \ -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
Beschikbare methoden
GET /v1/servicesZoek in de servicecatalogus en blader door de resultaten.GET /v1/statusBekijk de huidige opgeslagen status van één service.GET /v1/statusesBekijk de status van meerdere services in één verzoek.GET /v1/summaryVat waargenomen signalen samen voor een regio of geselecteerde services.GET /v1/historyBekijk opgeslagen waarnemingen door de tijd heen, met paginering.GET /v1/statsBereken verhoudingen van opgeslagen signaalsteekproeven, geen gemeten uptime.GET /v1/incidentsBekijk services met verhoogde signalen; dit zijn geen bevestigde wereldwijde storingen.Hoe de gegevens werken
UptimeScout slaat regionale waarnemingen op de achtergrond op. Elke respons bevat een waarnemingstijd en informatie over de actualiteit. Dezelfde dienst kan in verschillende regio’s andere signalen vertonen.
Een operationeel signaal betekent dat er in die opgeslagen steekproef geen verhoogde verstoring is waargenomen. Signalen voor verhoogde verstoring of storing beschrijven waargenomen omstandigheden, geen bevestigde wereldwijde storing. Ontbrekende of verouderde waarnemingen hebben een onbekende status. Verhoudingen op basis van steekproeven zijn geen gemeten uptimepercentages of SLA.
De interface wordt elke minuut vernieuwd. Controleer het observatietijdstip en de actualiteit van elke service om te beoordelen hoe recent de status is.
De taal bepaalt hoe informatie wordt weergegeven; de waarnemingsregio bepaalt op welk land de gegevens betrekking hebben. Je kunt deze onafhankelijk van elkaar wijzigen. Een vertaalde pagina impliceert niet automatisch dat de waarnemingen uit een bepaald land komen.
Alle dienstenLicentie- en verzoeklimieten
Gebruik je Evelode-licentiesleutel als Bearer-token. Bewaar deze op je server, buiten browsercode en openbare repositories. Alleen geslaagde verzoeken om gelicentieerde gegevens verbruiken je tegoed. Bij verlenging van een licentie of wijziging van het abonnement begint een nieuw tegoed; kalendermaanden zetten het tegoed niet opnieuw. Jaarabonnementen bieden een verzoekenbundel ter grootte van twaalf maandelijkse tegoeden voor de volledige jaarlijkse licentieperiode.
Betalingen, verlengingen, abonnementswijzigingen en licentiebeheer worden afgehandeld via Evelode.com. Het aantal toegestane verzoeken wordt opnieuw ingesteld wanneer de licentie wordt verlengd of het abonnement wordt gewijzigd. Dit gebeurt niet aan het begin van een kalendermaand. Jaarabonnementen bieden twaalf maandelijkse tegoeden als één verzoekenbundel voor de volledige looptijd van de licentie. De geschiedenis wordt opgebouwd vanaf de start van de verzameling. Voor het Free-abonnement worden geen terugkerende kosten in rekening gebracht.
PrijzenEen AI-assistent verbinden
Voeg de server-URL toe aan uw assistent, kies OAuth en log in met Evelode of voer uw licentiesleutel in op het verbindingsscherm. Een clientgeheim is niet nodig.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
Antwoorden verwerken
Controleer de HTTP-status voordat je gegevens uitleest: 400 betekent ongeldige parameters, 401 of 403 duiden op een probleem met de authenticatie of licentie, 409 betekent dat de licentievoorwaarden tijdens een verzoek zijn gewijzigd, 429 duidt op een verzoek- of frequentielimiet en 503 betekent dat de service tijdelijk niet beschikbaar is. Houd rekening met vertragingen bij nieuwe pogingen en voorkom herhaalde pogingen met korte tussenpozen.
Voorbeeld van opgeslagen waarnemingen
{
"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.179331Z",
"region": "US",
"service": {
"age_seconds": 16,
"category": "it",
"description": "Platform voor Git-repositories, samenwerking aan code, issues en softwarelevering.",
"description_language": "nl",
"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"
}