Dokumentacija REST API-ja
REST API-ji za hitne pozive
Registrirajte broj i adresu usluge, pratite status aktivacije i održavajte zapis ažurnim kada se lokacija promijeni.
Odaberite API i vjerodajnicu zajedno
Odobreni računi s profilima „Razvojni programeri i automatizacija”, „Poslovni” i „Pružatelji komunikacijskih usluga” mogu integrirati omogućene usluge. Pojedinačni programer ne mora se predstavljati kao tvrtka. SMS/MMS iz aplikacija zahtijeva odgovarajuće odobrenje za slanje i registraciju. Usluga „Pojedinci i obitelji” nema korisnicima dostupan API za slanje poruka.
| Obitelj API-ja | Osnovni URL | Autentifikacija i rezultat |
|---|---|---|
| Komunikacije v3 | https://api.multitel.net/v3 | Odobrene Basic vjerodajnice; prikladni dodijeljeni tokeni samo za operacije koje ih podržavaju. JSON status i response. |
| Registracija za hitne pozive | https://api.multi.tel/emergency | Odobrene Basic vjerodajnice ili posebno dodijeljen bearer pristup. JSON code, message i data. |
| REST integracije portala | Host i operacija prikazani u referenci za programere vašeg računa | Koristite dokumentiranu vjerodajnicu, opsege ovlasti i shemu te operacije. Zahtjevi iz sesije preglednika koriste zasebno sučelje. |
Prije korištenja primjera postavite MULTITEL_API_USERNAME i MULTITEL_API_PASSWORD putem konfiguracije tajni na vašem poslužitelju. Nikada ih ne ugrađujte u javni JavaScript preglednika, URL-ove ni upravljanje izvornim kodom. Namjenskim vjerodajnicama upravlja se u postavkama API integracije.
Čitanje pokrivenosti bez registracije broja
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multi.tel/emergency/coverage?environment=production"Podržan je i https://api.multitel.net/emergency. Nijedan osnovni URL hitnih službi ne sadrži /v3. Pokrivenost navodi međunarodne države, podržane vrste brojeva i cijene; prikladnost za sjevernoamerički E911 provjerava se tijekom registracije.
{
"code": 200,
"message": "",
"environment": "production",
"requestId": "EXAMPLE_REQUEST_ID",
"data": {}
}Ovo prikazuje samo ovojnicu. Shemu data svake operacije pročitajte u objavljenom vodiču za Emergency API.
Registrirajte, pratite status, zatim konfigurirajte pozivanje
- Za SAD/Kanadu i ostale podržane sjevernoameričke regije E911 navedite broj, E911 adresu i potrebne potvrde pristanka. Sjevernoamerički E911 dostupan je samo u produkciji.
- Za podržani međunarodni broj u vašem vlasništvu navedite spremljenu referencu na dokument ili identitet i adresu krajnjeg korisnika. Prethodno pregledajte zahtjeve za državu i vrstu broja.
- Pošaljite jedan zahtjev
POST /registrations. NeobavezniIdempotency-Keyidentificira logičku promjenu; sačuvajte ga i točan sadržaj zahtjeva pri ponovnim pokušajima. - Pročitajte
GET /registrations/:number. Provjerite životni ciklus,pendingiactionRequired; riješite potrebne ispravke. Prihvaćanje ili čekanje nije aktivna usluga. - Nakon aktivacije konfigurirajte ispravan ID pozivatelja za hitne slučajeve i put biranja specifičan za državu. Koristite postupak provjere usluge koji ne uključuje stvarni hitni poziv.
Međunarodne sandbox registracije su izolirane i ne aktiviraju stvarne hitne pozive. Za sjevernoamerički E911 potrebne su vjerodajnice glavnog računa; vodič objašnjava ograničenu podršku za međunarodne podračune.
Postupanje s pogreškama i ponovnim pokušajima
- Neuspjela autentifikacija ili dozvola
- Provjerite je li API vjerodajnica omogućena, koja je usluga dopuštena i koja ograničenja vrijede za izvornu IP adresu. Kolačić sesije portala nije vjerodajnica za integraciju.
- Nedovoljno sredstava ili neispunjeno odobrenje
- Riješite stanje računa, odobrenje za slanje ili zahtjev za dokumentom prije ponavljanja operacije.
- Nema rezultata
- Prazan inventar ili nedostajuće ime pozivatelja tretirajte kao uobičajen ishod. Ne pretpostavljajte da sintaktički ispravan broj ima sve usluge.
- Istek vremena čekanja na mreži ili kvar usluge
- Za čitanja koristite ograničen broj ponovnih pokušaja s odgodom (backoff). Za kupnju, slanje ili registraciju najprije provjerite stanje operacije; ponavljanje prihvaćenog zahtjeva može udvostručiti naplativu radnju.
Podrška za idempotentnost ovisi o pojedinoj obitelji API-ja. Emergency API podržava ključeve za ponovne pokušaje; to ne čini proizvoljne v3 zahtjeve idempotentnima. Za podršku sačuvajte vremenske oznake, vraćene ID-ove i odgovore iz kojih su uklonjeni osjetljivi podaci.
Nastavite s referencom za svoj račun
Referenca u koju ste prijavljeni filtrira operacije prema vašim dozvolama i omogućenim uslugama. Koristite njezin točan host, vrstu vjerodajnica, polja zahtjeva i shemu odgovora. Konzole mogu izvršavati operacije uživo, uključujući kupnje i poruke.