Verify Call

Verify Call brzi početak

Novauth jednom pozove telefon korisnika. Posljednjih 4–6 znamenki dolaznog broja je verifikacijski kod — bez tipkanja na Androidu, jedan pogled na iOS-u.

Testirate bez pravih poziva? Koristite Sandbox način rada — bez pravih poziva, uz predvidljive OTP kodove i bez naplate.

Tijek

Vaš poslužiteljPOST /call/flash s telefonskim brojem korisnika

NovauthUsmjerava poziv preko glasovnog operatora do korisnika

Telefon korisnikaZazvoni jednom — ID pozivatelja prikazuje verifikacijski broj

Vaša mobilna aplikacijaČita ID pozivatelja automatski (Android) ili ga korisnik vidi (iOS)

Vaš poslužiteljPOST /call/flash/webhook za potvrdu Success ili Failed

1Pokrenite flash poziv

Pošaljite POST zahtjev s telefonskim brojem korisnika. Novauth odmah usmjerava poziv preko glasovnog operatora.

POST/api/v1/connect-hub/call/flash

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/call/flash \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "callee": "+14155552671",
    "max_ring_time": 20
  }'

200 OK — Odgovor

json

{
  "uuid":   "01JQHM3P7KXNV8W2QF5DG6TYAB",   // save this — used for status reporting
  "caller": "12025550188",                      // number that will ring the user (no + prefix)
  "callee": "14155552671"                       // your user's number (no + prefix)
}

2Mobilna aplikacija čita ID pozivatelja

Ovaj korak se u potpunosti obavlja na klijentskom uređaju — nije potreban nijedan poziv prema poslužitelju.

Android: Koristite PhoneStateListener ili dozvolu READ_CALL_LOG da automatski pročitate dolazni ID pozivatelja — potpuno bez trenja. iOS: Korisnik nakratko vidi dolazni broj na zaslonu i dodirne Ignoriraj — i dalje brže od tipkanja šesteroznamenkastog koda.

Posljednjih 4–6 znamenki polja caller iz koraka 1 služi kao OTP. Usporedite ih s onim što mobilna aplikacija pročita, a zatim prijavite rezultat u koraku 3.

3Prijavite rezultat verifikacije

Nakon što vaša mobilna aplikacija utvrdi jesu li se ID-jevi pozivatelja poklopili, vaš backend prijavljuje ishod natrag Novauthu. Time se zatvara zapis poziva i omogućuje analitika.

POST/api/v1/connect-hub/call/flash/webhook

bash

# After your mobile app reads the caller ID, report the result:
curl -X POST https://api.novauth.com/api/v1/connect-hub/call/flash/webhook \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "uuid": "01JQHM...",
    "status": "Success"
  }'

# status options:
#   "Success"     — user verified (caller ID matched)
#   "Failed"      — call failed or user rejected
#   "Incomplete"  — call started but not resolved
#   "WrongNumber" — user reports wrong number received

4Preuzmite detaljni zapis poziva (opcionalno)

Povucite kompletan CDR za otklanjanje grešaka, reviziju ili analizu prijevara. Vraća vremenske oznake, trajanje i ishod.

CDR je dostupan tek nakon što se poziv u potpunosti završi. Ako ga zatražite odmah nakon pokretanja, odgovor će biti null — pričekajte nekoliko sekundi ili ga preuzmite nakon primitka webhook callbacka.

GET/api/v1/connect-hub/call/flash/{uuid}/cdr

bash

# Get full call detail record
curl https://api.novauth.com/api/v1/connect-hub/call/flash/01JQHM.../cdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

API referenca

POST/call/flashPokrenite flash poziv

POST/call/flash/webhookPrijavite ishod verifikacije

GET/call/flash/{uuid}/cdrPreuzmite detaljni zapis poziva

POST/call/flash/cdrIzlistajte sve CDR-ove (paginirano)

DELETE/call/flash/{uuid}Prekinite / otkažite poziv koji zvoni

Otkažite poziv koji zvoni

bash

# Cancel a ringing call before it's answered
curl -X DELETE https://api.novauth.com/api/v1/connect-hub/call/flash/01JQHM... \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

Vrijednosti statusa webhooka

SuccessID pozivatelja verificiran — korisnik je autentificiran

FailedPoziv nije uspio, prekinut je ili ga je korisnik odbio

IncompletePoziv je pokrenut, ali ishod nije utvrđen

WrongNumberKorisnik prijavljuje da je dolazni broj bio neočekivan