Dokumentacija REST API-ja
REST API-ji za SMS i MMS
Šaljite odobrene poruke aplikacije te obrađujte prihvaćanje, događaje isporuke, segmentaciju i naknade.
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.
Priprema SMS zahtjeva
Koristite odobren broj za slanje s omogućenim SMS-om koji je u vlasništvu računa, primatelja koji je pristao na poruku te potrebnu registraciju Brand/Campaign ili provjeru broja s besplatnim pozivima za pozivatelja. Donji primjer šalje stvarnu poruku kada se popuni ispravnim vjerodajnicama i brojevima; nije sandbox.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"Zamijenite rezervirana mjesta pošiljatelja i primatelja telefonskim brojevima u međunarodnom formatu, samo znamenkama i uz pozivni broj države. Za MMS navedite podržani javno dostupan URL medija u media te prethodno provjerite uvjete za MMS i cijene.
Prihvaćanje nije isporuka
Provjerite i vanjski status aplikacije i vraćeni rezultat slanja poruke. Zabilježite identifikator poruke koji daje usluga te pratite status isporuke i webhook događaje. Uspješno slanje ne može dokazati da je uređaj primatelja primio poruku.
SMS se naplaćuje po segmentu. Kodiranje i duljina poruke mogu dovesti do više segmenata; mediji i naknade povezane s operaterima mogu se razlikovati od SMS-a. Prije slanja pročitajte trenutnu prodajnu cijenu računa. Nikada slijepo ne ponavljajte slanje koje je isteklo: najprije provjerite zabilježeni ishod.
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.