SMS Gateway

SMS brzi početak

Šaljite OTP kodove, upozorenja i transakcione SMS poruke u više od 190 zemalja. Svaka poruka vraća potvrdu isporuke, tako da znate da je stigla.

Testirate bez pravih SMS poruka? Koristite Sandbox režim — bez slanja pravih poruka, uz predvidljive OTP kodove i bez naplate.

1Pošaljite SMS

Pošaljite POST sa brojem primaoca i tekstom poruke. Polje from postavlja ID pošiljaoca vidljiv korisniku (podrška operatera varira po zemljama).

POST/api/v1/connect-hub/sms

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/sms \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to":   "+14155552671",
    "text": "Your verification code is 482951. Valid for 10 minutes.",
    "from": "Novauth"
  }'

200 OK — Odgovor

json

{
  "messageId": "a3f2c1d0-4e5b-6c7d-8e9f-0a1b2c3d4e5f",  // save for delivery check
  "from":      "Novauth",
  "to":        "+14155552671"
}

Dužina teksta: SMS poruke su ograničene na 160 karaktera po segmentu. Prihvataju se poruke do 4 096 karaktera — automatski se dijele na povezane segmente i ponovo sastavljaju na uređaju.

2Provjerite status isporuke

Ispitujte SDR (izvještaj o isporuci SMS-a) endpoint da provjerite da li je poruka stigla na uređaj. Provjerite ubrzo nakon slanja — tipična isporuka traje manje od 5 sekundi.

GET/api/v1/connect-hub/sms/{messageId}/sdr

bash

curl https://api.novauth.com/api/v1/connect-hub/sms/a3f2c1d0-.../sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

3Prijavite ishod verifikacije

Kada vaš korisnik pošalje kod koji je primio, POST-ujte rezultat na webhook endpoint da zatvorite SMS zapis i zabilježite ishod.

POST/api/v1/connect-hub/sms/webhook

bash

# Report the verification outcome from your backend
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/webhook \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id":     "a3f2c1d0-...",
    "status": "Success"
  }'

API referenca

POST/smsPošaljite SMS poruku

GET/sms/{messageId}/sdrPreuzmite izvještaj o isporuci SMS-a

POST/sms/webhookPrijavite ishod verifikacije

POST/sms/sdrIzlistajte sve SMS zapise (paginirano)

Tijelo zahtjeva — POST /sms

tostringrequiredTelefon primaoca u E.164 formatu

textstringrequiredSadržaj poruke (1–4 096 karaktera)

fromstringoptionalID pošiljaoca ili broj (zavisi od operatera)

Izlistajte sve SMS zapise

bash

# Paginated list of all SMS records
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "rows_per_page": 20,
    "sort_by": "created_at",
    "sort_direction": "DESC"
  }'