# UptimeScout API-documentatie

Servicestatus, regionale signalen en geschiedenis via REST, SDK's en MCP. Bouw dashboards en geef AI-assistenten duidelijke context over beschikbaarheid.

URL: https://uptimescout.com/nl/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"
```

## Beschikbare methoden

- `GET /v1/services`: Zoek in de servicecatalogus en blader door de resultaten.

- `GET /v1/status`: Bekijk de huidige opgeslagen status van één service.

- `GET /v1/statuses`: Bekijk de status van meerdere services in één verzoek.

- `GET /v1/summary`: Vat waargenomen signalen samen voor een regio of geselecteerde services.

- `GET /v1/history`: Bekijk opgeslagen waarnemingen door de tijd heen, met paginering.

- `GET /v1/stats`: Bereken verhoudingen van opgeslagen signaalsteekproeven, geen gemeten uptime.

- `GET /v1/incidents`: Bekijk 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.

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

## Een AI-assistent verbinden

Verbind een Streamable HTTP MCP-client met het onderstaande eindpunt en geef je licentiesleutel op in de Authorization-header. Zeven alleen-lezen tools bieden servicestatussen, regionale signalen en geschiedenis. Dezelfde licentielimieten zijn van toepassing.

https://mcp.uptimescout.com

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

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