uptimescout
API-sleutel aanvragen

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 diensten

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

Prijzen

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

UptimeScout verbinden

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"
}

Snelle weergave

Opgeslagen waarnemingen laden

Signalen in de loop van de tijd

Elk interval toont het vaakst waargenomen signaal. Bij gelijke aantallen bepaalt het meest recent waargenomen signaal de kleur. Selecteer een kolom voor het volledige overzicht.