API-reference

Et lille, stabilt REST API til at administrere overvågninger og kanaler og polle efter ændringer. Samme overflade som dashboardet.

Base URL

Produktion: https://api.pagedeltas.com. Alle endpoints har præfikset /api. Vellykkede svar er JSON.

Autentificering

Opret en nøgle fra Indstillinger → API-nøgler (redaktør- eller administratorrolle kræves). Nøglen vises kun én gang ved oprettelse — kopiér den straks. For at tilbagekalde en nøgle skal du slette den fra samme side.

Authorization: Bearer pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Nøgler er begrænset til den organisation, der oprettede dem, og fungerer med administratoradgang i den pågældende organisation, uafhængigt af en specifik bruger. De er ikke bundet til et medlem, så fjernelse af en kollega tilbagekalder ikke organisationens nøgler — slet selve nøglen for at fjerne adgangen.

Fejl

Fejl returnerer en ikke-2xx status. Autentificerings- og tilladelsesfejl returneres som en kort almindelig tekstbesked (f.eks. unauthorized, forbidden); kvote- og hastighedsbegrænsningsfejl returnerer et lille JSON-svar med en besked og de relevante tal. Analyser ikke en fast fejlstruktur — opdel i stedet baseret på HTTP-statuskoden:

400 — forkert formateret anmodning (ugyldig JSON, ugyldig URL, manglende felt).
401 — manglende eller ugyldige legitimationsoplysninger.
403 — autentificeret, men din rolle mangler tilladelse til denne handling.
404 — ressource mangler eller findes ikke i din organisation.
409 — konflikt (f.eks. er overvågningen sat på pause på grund af gentagne blokeringer).
422 — en kvote ville blive overskredet (f.eks. din plans overvågningsgrænse). JSON-svaret inkluderer current og limit.
429 — hastighedsbegrænset (manuelle tjek). Vent og prøv igen efter forsinkelsen i Retry-After.

Eksempel på kvotefejl (422):

{
  "error": "plan_url_limit exceeded",
  "current": 100,
  "limit": 100,
  "message": "Creating this monitor would exceed your plan's monitor limit (100)."
}

Endpoint-reference

Metode & sti	Beskrivelse
`GET /api/monitors`	Vis overvågninger i din organisation.
`POST /api/monitors`	Opret en enkelt overvågning.
`GET /api/monitors/{id}`	Hent en enkelt overvågning.
`PATCH /api/monitors/{id}`	Opdater `url`, `nl_description`, `filter_prompt`, `css_selector`, `xpath_selector`, `status`.
`DELETE /api/monitors/{id}`	Slet en overvågning og dens historik.
`POST /api/monitors/{id}/check-now`	Sæt et øjeblikkeligt tjek i kø, der omgår tidsplanen (hastighedsbegrænset, se nedenfor).
`GET /api/monitors/{id}/changes`	Vis registrerede ændringer for en overvågning (understøtter `?limit=`, maks. 100).
`POST /api/monitors/import`	Masseimport via multipart CSV-upload (feltet `file`).
`POST /api/monitors/bulk-pause`, `bulk-resume`, `bulk-delete`	Anvend en handling på en liste af overvågnings-id'er.
`GET\|PUT /api/monitors/{id}/alert-channels`	Læs eller udskift en overvågnings kanal-tilsidesættelser.
`GET /api/alert-channels`	Vis notifikationskanaler.
`POST /api/alert-channels`	Opret en kanal.
`PATCH\|DELETE /api/alert-channels/{id}`	Opdater eller slet en kanal.
`POST /api/alert-channels/{id}/test`	Send en test-payload for at bekræfte levering.
`GET\|POST /api/sitemap-monitors`	Vis eller opret sitemap-overvågninger.
`POST /api/sitemap-monitors/import`	Opret sitemap-overvågninger i bulk via multipart CSV-upload (feltet `file`).
`GET\|POST\|DELETE /api/tokens`	Vis, opret og slet API-nøgler.
`GET /api/billing/plan`	Din organisations aktuelle plan og grænser.
`GET /api/plans`	Offentlig — vis tilgængelige planer (ingen autentificering kræves).

Eksempel — opret en overvågning

curl -X POST https://api.pagedeltas.com/api/monitors \
  -H "Authorization: Bearer $PAGEDELTAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/pricing",
    "nl_description": "Competitor pricing; alert on plan or price changes",
    "filter_prompt": "Alert on plan or price changes; ignore copy tweaks",
    "channel_ids": []
  }'

Valgfrie felter: filter_prompt, css_selector, xpath_selector, is_pdf og channel_ids (kanaltilsidesættelser pr. overvågning; udelad for at bruge organisationens standarder). Der er ingen frequency — tidsplanlægningen er adaptiv.

Eksempel — poll for ændringer

GET /api/monitors/01HW2X.../changes?limit=50
Authorization: Bearer $PAGEDELTAS_TOKEN

Returnerer de seneste ændringer først (standard 50, maks. 100). Der er ingen markør (cursor) — skift side ved at justere limit og spore den seneste detected_at, du allerede har set.

{
  "changes": [
    {
      "id": "01HW3...",
      "detected_at": "2026-06-01T08:42:00Z",
      "summary": "Pro plan increased from $29 to $39/month."
    }
  ]
}

Hastighedsgrænser

Der er i øjeblikket ingen hastighedsgrænser pr. nøgle på læse- og skrive-endpoints. Den eneste undtagelse er manuelle tjek:

Check-now: 1 anmodning / minut / overvågning.

Når du rammer denne grænse, er svaret 429 med en Retry-After-header i sekunder. Overhold venligst en fornuftig hastighed på de andre endpoints.

Versionering

Vi sigter mod at holde denne overflade stabil. Nye felter og endpoints kan blive tilføjet uden varsel, så skriv klienter, der ignorerer ukendte JSON-felter.