Avtaler

Hent avtaler

Kommende avtaler kommer først, med den nærmeste øverst. when=past gir dem som har vært, nyeste først. Begge listene blar med cursor, og en cursor hører til lista den kom fra. Står det forespørsler og venter, finner du dem med status=pending.

?when

upcoming eller past. Standard er upcoming.

?limit

1 til 200. Standard er 50.

?status

pending, confirmed, declined eller cancelled. Utelat for alle.

?cursor

next_cursor fra forrige side.

{
  "bookings": [
    {
      "id": "5f0c2a8e-3b1d-4c6f-9a7e-2d8b1c4e6f90",
      "name": "Kari Nordmann",
      "email": "kari@example.no",
      "phone": "912 34 567",
      "message": "Klipp og farge.",
      "starts_at": "2026-10-02T08:00:00.000Z",
      "duration_minutes": 60,
      "mode": "slot",
      "status": "pending",
      "created_at": "2026-09-24T17:41:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/bookings?when=upcoming&limit=20"

Hent én avtale

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
booking_id="5f0c2a8e-3b1d-4c6f-9a7e-2d8b1c4e6f90"

skribb "/bookings/$booking_id"

Bekreft, avslå eller avlys en avtale

Et svar går til den besøkende på e-post, den samme e-posten som når du svarer fra Avtaler i skribb, med din adresse som svaradresse. En bekreftelse har lenker for å legge avtalen i kalenderen. En forespørsel som venter, kan bekreftes eller avslås, og en bekreftet avtale kan avlyses, så lenge tidspunktet ikke har vært. Sender du statusen avtalen allerede har, får du den tilbake uten at noen får e-post, så det er trygt å prøve igjen om svaret går tapt.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
booking_id="5f0c2a8e-3b1d-4c6f-9a7e-2d8b1c4e6f90"

skribb "/bookings/$booking_id" \
  -X PATCH \
  -H "content-type: application/json" \
  -d '{
    "status": "confirmed"
  }'

Slett en avtale for godt

Dette er sletting, ikke et svar: den besøkende får ingen beskjed, og kalenderlenken i bekreftelsen slutter å virke. Vil du si fra, avslå eller avlys først. Går an uansett status. Sletting logges med nøkkelens id.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
booking_id="5f0c2a8e-3b1d-4c6f-9a7e-2d8b1c4e6f90"

skribb "/bookings/$booking_id" \
  -X DELETE