API-referanse
Meldinger (Varsling)

Meldinger (Varsling)

Send SMS, e-post og push, enkeltvis eller i batch, med maler og leveringsstatus.

POST/v1/meldingerSend melding
GET/v1/meldinger/{id}Hent status
POST/v1/meldinger/batchSend batch

POST/v1/meldinger

Send melding

Sender én melding til én mottaker. Kanalene prøves i oppgitt rekkefølge til én lykkes. Svarer 202 og leverer status som webhook.

Kropp (JSON)

tilobjectpåkrevd
«mobil» (E.164), «epost» og/eller «enhet_id» for push.
kanalerstring[]påkrevd
Rekkefølge: «push», «sms», «epost».
malstring
Mal-ID fra dashbordet. Alternativt «tekst» og «emne».
variablerobject
Verdier til malen.
send_tidligstdatetime
Utsatt sending.
tidsvindustring
F.eks. «08:00-20:00». Meldinger utenfor vinduet holdes til neste åpning.
formaalstring
«transaksjon» (standard) eller «marked». Marked sjekkes mot reservasjonslisten.

forespørsel

curl -X POST https://api.spireapi.com/v1/meldinger \
  -H "Authorization: Bearer sk_test_…" -H "Content-Type: application/json" \
  -d '{"til":{"mobil":"+4791234567"},"kanaler":["sms"],"tekst":"Koden din er 482913"}'

svar

{ "id": "msg_01JBX6A3W8ZK", "status": "kø", "kanaler": ["push", "sms", "epost"], "deler_estimert": 1 }

GET/v1/meldinger/{id}

Hent status

Status, valgt kanal, forsøk per kanal og kostnad.

Stiparametre

idstringpåkrevd
Meldings-ID.

forespørsel

curl https://api.spireapi.com/v1/meldinger/msg_01JBX6A3W8ZK \
  -H "Authorization: Bearer sk_test_…"

svar

{
  "id": "msg_01JBX6A3W8ZK",
  "status": "levert",
  "kanal_valgt": "sms",
  "forsok": [ { "kanal": "push", "status": "ingen_enhet" }, { "kanal": "sms", "status": "levert", "levert": "2026-11-03T10:02:17Z", "deler": 1 } ],
  "kostnad": { "belop": 0.59, "valuta": "NOK" }
}

POST/v1/meldinger/batch

Send batch

Opptil 10 000 mottakere i ett kall med felles mal og individuelle variabler. Hastighet styres per batch.

Kropp (JSON)

mottakereobject[]påkrevd
Hver: «til» og valgfritt «variabler».
malstringpåkrevd
Mal-ID.
kanalerstring[]påkrevd
Som for enkeltmelding.
hastighetinteger
Meldinger per sekund, 1–500. Standard 50.

forespørsel

curl -X POST https://api.spireapi.com/v1/meldinger/batch \
  -H "Authorization: Bearer sk_test_…" -H "Content-Type: application/json" -d @batch.json

svar

{ "id": "bat_01JBX9Q0", "status": "kø", "antall": 11042, "estimert_ferdig": "2026-11-03T10:05:40Z" }

Fant du en feil? Si fra, så retter vi innen en virkedag.