Analizirajte točan tekst poruke
Izračunajte kodiranje, duljinu kodiranog teksta i broj SMS segmenata za tekst koji namjeravate poslati. Ova krajnja točka ne šalje SMS, ne rezervira rutu niti vraća ponudu cijene isporuke. Pošaljite cjelokupan konačni tekst, uključujući svako podnožje, poveznicu ili tekst za odjavu koji dodaje vaš postupak slanja.
Zahtjev
Autentificirajte se pomoću svojeg omogućenog API računa i njegove dopuštene izvorne IP adrese. Vjerodajnice čuvajte u spremištu tajni na poslužitelju. U polju text pošaljite niz znakova kodiran prema standardu UTF-8; primjer upotrebljava varijable okruženja.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--data-urlencode 'text=Your message here' \
https://api.multitel.net/v3/smslengthPodržani su ulazni podaci kodirani kao obrazac. Objekt JSON poput {"text":"Your message here"} također se prihvaća ako nisu navedena polja obrasca ni parametri upita. Dajte prednost metodi POST kako se tekst poruke ne bi pojavio u URL-u. Ako su prisutni i podaci obrasca i parametri upita, upotrebljava se obrazac. Nemojte miješati formate zahtjeva.
Odgovor
{
"status": {
"code": "200",
"msg": ""
},
"response": {
"charset": 0,
"encoding": "GSM-7",
"count": 1,
"parts": 1,
"chars": 17,
"units": 17,
"single_limit": 160,
"multipart_limit": 153
}
}| Polje | Značenje |
|---|---|
| charset | 0 za GSM-7 ili 2 za UTF-16. |
| encoding | GSM-7 ili UTF-16. |
| parts, count | Dva naziva za izračunati broj SMS segmenata. Obje su vrijednosti nula za prazan tekst. |
| units, chars | Dva naziva za kodirane jedinice. One ne moraju odgovarati vidljivim znakovima. |
| single_limit | Ograničenje broja kodiranih jedinica za jedan segment s odabranim kodiranjem. |
| multipart_limit | Ograničenje broja kodiranih jedinica koje se primjenjuje na svaki segment nakon što se uračunaju dodatni podaci potrebni za povezivanje segmenata. |
Kodiranje i ograničenja segmenata
| Kodiranje | Jedan segment | Segment višedijelne poruke |
|---|---|---|
| GSM-7 | 160 septeta | 153 septeta |
| UTF-16 | 70 kodnih jedinica | 67 kodnih jedinica |
Znakovi iz proširenog skupa GSM-7, kao što su ^, vitičaste zagrade, uglate zagrade, obrnuta kosa crta, okomita crta, tilda i znak eura, zauzimaju dva septeta. Znak izvan skupa GSM-7 prebacuje cijelu poruku na brojanje prema kodiranju UTF-16. Emoji izvan osnovne višejezične ravnine zauzima dvije jedinice kodiranja UTF-16; vidljivi niz emojija može sadržavati nekoliko kodnih točaka.
Primjerice, 160 običnih slova iz skupa GSM-7 stane u jedan segment, a 161 zahtijeva dva. Osamdeset znakova ^ zauzima 160 jedinica i stane u jedan segment; osamdeset jedan zauzima 162 jedinice i zahtijeva dva. Trideset pet jednostavnih emojija izvan osnovne višejezične ravnine zauzima 70 jedinica kodiranja UTF-16 i stane u jedan segment; trideset šest zauzima 72 jedinice i zahtijeva dva. Kombinirajuće oznake i povezani emojiji mogu promijeniti te brojeve.
Pogreške i prazan tekst
Ako nedostaje polje text, ako se umjesto skalarne vrijednosti pošalje polje ili objekt ili ako kodiranje UTF-8 nije valjano, API vraća kod 403. U odgovoru JSON pročitajte status.code i status.msg, kao i HTTP status; ova krajnja točka vraća kod kao niz znakova. Prazan niz znakova valjan je i vraća nula jedinica i nula segmenata.
Upotrijebite rezultat prije slanja
Pregledani kalkulator ne šalje poruke, ne upućuje pozive operateru niti tereti račun. Njegov je rezultat analiza poslanog teksta, a ne jamstvo isporuke ili konačni račun. Pri slanju mogu se primjenjivati cijene prema odredištu, naknade operatera, zahtjevi kampanje i dodatne preinake teksta. Nakon promjene poruke ponovite izračun, a zatim upotrijebite odobreni postupak slanja i važeći cjenik svojeg računa.