Abonnenter

Hent abonnentlista

Krever at du har godtatt Tillegg E i databehandleravtalen. Har du ikke det, svarer ruta 403 dpa-not-accepted, også om nøkkelen ellers er i orden.

?status

venter, bekreftet eller avmeldt.

?limit

1 til 1000. Standard er 1000.

?cursor

next_cursor fra forrige side.

{
  "subscribers": [
    {
      "email": "kari@example.no",
      "status": "bekreftet",
      "frequency": "hver-gang",
      "confirmed_at": "2026-05-02T10:14:00.000Z",
      "unsubscribed_at": null,
      "created_at": "2026-05-02T10:11:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/subscribers?status=paid&limit=20"

Be en adresse om å bekrefte

Adressen får den samme bekreftelses-e-posten som når noen melder seg på selv, og blir abonnent først når de trykker på lenka. Ruta svarer 202, ikke 201. Adressen dukker ikke opp i GET /v1/subscribers før den er bekreftet, så lytt på subscriber.confirmed i stedet for å spørre etter den. Svaret er likt enten adressen er ny, allerede venter eller har meldt seg av før. Ruta har en egen, strammere grense enn resten av API-et. Er lista full, svarer vi 409 list-full. Krever Tillegg E, som lesinga.

{
  "email": "kari@example.no",
  "confirmation_sent": true
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/subscribers" \
  -X POST \
  -H "content-type: application/json" \
  -d '{
    "email": "kari@example.no"
  }'

Meld av en adresse

Adressen er id-en. Legg den i stien, url-kodet. Raden blir ikke slettet, den blir merket avmeldt: en slettet rad kan neste import legge inn igjen. Ruta svarer 200 også for en adresse som aldri har stått på lista.

{
  "email": "kari@example.no",
  "unsubscribed": true,
  "mirrored": true
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
subscriber_email="abc123"

skribb "/subscribers/$subscriber_email" \
  -X DELETE