SMS API

SMS API til enterprise-beskeder

Send transaktions- og bulk-SMS fra dine egne systemer gennem ét REST API. Godkend med en API-nøgle, følg hver besked med signerede leveringswebhooks, og nå kunder over hele verden gennem ZafeConnects netværk.

REST · JSON · API-nøgle · signerede webhooks

Kort sagt

SMS API’et i korte træk

ZafeConnects SMS API er et REST API (JSON, godkendelse med API-nøgle) til at sende, planlægge og følge SMS. Det understøtter bulk-afsendelse af op til 10.000 beskeder pr. forespørgsel, signerede leveringswebhooks og fallback på tværs af SMS, RCS, WhatsApp og e-mail.

Basis-URL
https://api.zafeconnect.com, alle endpoints under /v1
Godkendelse
Headeren X-API-Key; live- og testnøgler
Grænser
1.000 forespørgsler pr. minut pr. nøgle; bulk: op til 10.000 beskeder pr. forespørgsel og 100 forespørgsler pr. minut
Webhooks
Signeret med HMAC-SHA256; enhver 2xx bekræfter; prøves op til 5 gange igen
Kanaler
sms, rcs, whatsapp, email, med valgfri reserverækkefølge
Dokumentation
API-dokumentation på /developers (engelsk); OpenAPI 3.1-fil på /openapi.json
Prismodel
Betaling pr. leveret besked. Ingen oprettelses-, system- eller driftsgebyrer og intet abonnement.

Det kan den

Send, planlæg og følg SMS fra dine egne systemer

Ét REST API dækker en beskeds hele forløb, fra afsendelse til den endelige leveringsstatus.

Send én besked

POST /v1/messages/send sender en besked til et telefonnummer i E.164-format. Det samme kald understøtter også RCS, WhatsApp og e-mail.

Send i bulk

POST /v1/messages/bulk accepterer op til 10.000 beskeder i én forespørgsel. Hver besked sættes i kø for sig.

Planlæg og annuller

Sæt scheduled_at for at sende senere, og annuller en besked, så længe den stadig er planlagt.

Følg hver besked

Hent status for en besked via dens ID, eller modtag statusændringer som signerede webhooks.

Administrer kontoen

Se din saldo, dine priser pr. kanal og land og dit forbrug for en periode.

Eksempel

Din første forespørgsel

Det dokumenterede afsendelseskald: én forespørgsel og ét JSON-svar med det besked-ID, du kan følge.

Forespørgsel
curl -X POST https://api.zafeconnect.com/v1/messages/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+4520123456",
    "channel": "sms",
    "message": "Hello from ZafeConnect!",
    "sender": "MyBrand"
  }'
Svar
{
  "message_id": "msg_01j2abc...",
  "status": "queued",
  "channel": "sms",
  "to": "+4520123456",
  "cost": 0.00,
  "currency": "EUR",
  "created_at": "2026-05-27T12:00:00Z"
}

Eksemplets værdier er illustrative. Feltreference, fejlkoder, bulk-afsendelse, webhooks og signaturverifikation findes i API-dokumentationen (på engelsk). OpenAPI 3.1

Prøv det

Følg en besked gennem ZafeConnect

Vælg, hvordan du vil sende, og tryk på knappen. Forespørgslen er det dokumenterede kald; rejsen og leveringshændelsen er en simulation. Der sendes intet, og værdierne er eksempler.

Simulatoren kræver JavaScript. Den dokumenterede forespørgsel og det dokumenterede svar står i eksemplet ovenfor.

Simulation. Der sendes ingen besked, og ingen konto bruges. Levering er aldrig garanteret; kun eksempelværdier.

Bygget til produktionstrafik

Godkendelse, grænser og signerede webhooks

Det er de dokumenterede standardværdier. Forventer du større mængder eller kraftige spidsbelastninger, så fortæl os det, så planlægger vi opsætningen sammen.

Godkendelse med API-nøgle

Send din nøgle i headeren X-API-Key. Der findes nøgler til live- og testmiljøer, så du kan integrere, før du sender rigtig trafik.

Dokumenterede grænser

Enkeltafsendelser: 1.000 forespørgsler pr. minut pr. nøgle. Bulk: op til 10.000 beskeder pr. forespørgsel og 100 forespørgsler pr. minut.

Signerede leveringswebhooks

Statusændringer sendes til din URL med en HMAC-SHA256-signatur, du kan verificere. Svar med en vilkårlig 2xx-status for at bekræfte; ZafeConnect prøver op til 5 gange igen.

JSON ind, JSON ud

Alle forespørgsler og svar er JSON i UTF-8 med standard HTTP-statuskoder som 201, 400, 401 og 402.

Levering

Global rækkevidde og routing bag ét endpoint

API’et er indgangen. Bagved rejser beskederne over direkte operatørforbindelser og partner-direkte ruter, med fallback, hvis en rute har problemer.

Én integration, mange lande

Det samme kald når kunder i forskellige lande. Dækning og funktioner varierer efter destination, så fortæl os, hvor dine kunder er.

Intelligent routing og fallback

Trafikken følger den bedste tilgængelige rute pr. destination, med alternative ruter eller regioner ved netværksproblemer.

Rigtige leveringsrapporter

Leveringsstatus kommer fra operatørernes egne leveringsrapporter, hvor operatøren returnerer dem.

Fallback på tværs af kanaler

Angiv kanaler i prioriteret rækkefølge, for eksempel SMS først og e-mail som reserve. API’et prøver den næste kanal, hvis den primære fejler.

Afsenderidentitet

Send under dit eget brandnavn

Brug feltet sender til at vise dit brandnavn, hvor destinationslandet tillader det.

Kun godkendte afsendere

Afsenderen skal være et godkendt SenderID. Vi guider dig gennem registreringen, hvor et land kræver det.

11 tegn på SMS

Alfanumeriske afsendernavne er begrænset til 11 tegn på SMS.

Hold dit navn for dig selv

SenderID Protection hjælper med at forhindre, at andre bruger dit afsendernavn, hvor operatører eller registre understøtter beskyttelse.

Kom i gang

Fra første forespørgsel til live trafik

  1. 1

    Bed om adgang

    Fortæl os dine destinationslande, kanaler og forventede mængder. Vi bekræfter, hvad der gælder, og opretter din konto.

  2. 2

    Integrér med en testnøgle

    Byg mod de dokumenterede endpoints med en test-API-nøgle, og kontrollér svarene.

  3. 3

    Tilføj webhooks

    Peg leveringshændelser mod dit endpoint, og verificér signaturen.

  4. 4

    Gå live

    Skift til en live-nøgle. Du kan være live på så lidt som 2 uger fra det øjeblik, du beslutter dig for at komme i gang.

FAQ

SMS API: ofte stillede spørgsmål

Hvad er et SMS API?

Et SMS API lader din applikation sende tekstbeskeder og læse deres leveringsstatus ved at sende HTTP-forespørgsler i stedet for at bruge en webgrænseflade. ZafeConnects API er et REST API med JSON-forespørgsler og -svar.

Er et SMS API det samme som en SMS-gateway?

Udbydere bruger begge begreber om forbindelsen mellem dine systemer og mobilnetværkene. ZafeConnect tilbyder den som et REST API med godkendelse via API-nøgle. Har du brug for en anden forbindelsesmetode, for eksempel SMPP, så fortæl os det, og vi bekræfter, hvad der er muligt.

Hvordan godkender jeg?

Send din API-nøgle i headeren X-API-Key i hver forespørgsel. Nøgler oprettes og administreres i din ZafeConnect-konto og findes til live- og testmiljøer.

Hvad er grænserne?

De dokumenterede grænser er 1.000 forespørgsler pr. minut pr. nøgle til enkeltafsendelser og op til 10.000 beskeder pr. bulk-forespørgsel med 100 bulk-forespørgsler pr. minut. Fortæl os om større mængder, så planlægger vi opsætningen med dig.

Hvordan får jeg leveringsstatus?

Hent en besked via dens ID, eller modtag webhooks, når status ændrer sig. Hver webhook er signeret med HMAC-SHA256, så du kan verificere, at den kommer fra ZafeConnect, og ZafeConnect prøver op til 5 gange igen, hvis dit endpoint ikke bekræfter.

Kan jeg sende engangskoder og andre transaktions-SMS?

Ja. Transaktionsbeskeder som engangskoder, alarmer og notifikationer er den mest almindelige brug af API’et.

Kan jeg sende RCS, WhatsApp eller e-mail med det samme API?

Ja. Afsendelses-endpointet tager en kanal (sms, rcs, whatsapp eller email) og en valgfri liste af reservekanaler. Tilgængeligheden varierer efter land og kanal.

Hvordan prissættes SMS API’et?

Du betaler kun for leverede beskeder, uden oprettelses-, system- eller driftsgebyrer. Beløbet trækkes fra din forudbetalte saldo eller faktureres månedligt for enterprise-kunder.

Klar til at integrere?

Fortæl os om dine systemer, destinationer og mængder. Vi hjælper dig med at sende din første besked, og du kan være live på så lidt som 2 uger.