Läs-API:t — endpoints och exempel

Läs-API:t ger dig din övervakningsdata som JSON: sajter, monitorer, incidenter, månadens SLA-data och svarstidsserier. Allt är skrivskyddat och begränsat till ditt eget konto.

Autentisering

Skapa en nyckel under Inställningar → API (läsbehörighet) och skicka den i headern X-API-Key. Nycklar visas en gång — spara dem säkert. Varje nyckel har egen hastighetsgräns; 429 betyder att du anropar för ofta.

Endpoints

• GET /api/v1/monitoring/sites — alla aktiva sajter med status.
• GET /api/v1/monitoring/sites/{site} — en sajt: monitorer, status, 30 dagars upptid, p95.
• GET /api/v1/monitoring/sites/{site}/incidents — incidentlogg (paginerad, ?per_page= upp till 100).
• GET /api/v1/monitoring/sites/{site}/uptime?year=2026&month=8 — månadens SLA-rapport som JSON.
• GET /api/v1/monitoring/sites/{site}/monitors/{monitor}/series?range=24h|7d|30d — snitt/p95-serie per timme eller dag.

{site} och {monitor} är de publika id:na från API:t (t.ex. rhuuiltnynyn) — samma som syns i appens adresser.

curl

curl -H "X-API-Key: DIN_NYCKEL" https://ravnsight.com/api/v1/monitoring/sites

PHP

$ch = curl_init('https://ravnsight.com/api/v1/monitoring/sites');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: DIN_NYCKEL']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$sites = json_decode(curl_exec($ch), true)['data'];
foreach ($sites as $site) {
    echo $site['name'] . ': ' . $site['state'] . PHP_EOL;
}

Python

import requests

r = requests.get(
    'https://ravnsight.com/api/v1/monitoring/sites',
    headers={'X-API-Key': 'DIN_NYCKEL'}, timeout=10)
for site in r.json()['data']:
    print(site['name'], site['state'])

JavaScript

const res = await fetch('https://ravnsight.com/api/v1/monitoring/sites', {
  headers: { 'X-API-Key': 'DIN_NYCKEL' },
});
const { data } = await res.json();
data.forEach(site => console.log(site.name, site.state));

Felkoder

• 401 — nyckel saknas/ogiltig.
• 403 — planen saknar API-åtkomst (Pro och uppåt), eller nyckeln saknar läsbehörighet.
• 404 — okänt sajt-/monitor-id (eller inte ditt).
• 429 — hastighetsgränsen nådd; försök igen om en minut.