Arvuta SMS-i kodeering ja segmentide arv

Analüüsi sõnumi täpset teksti

Arvuta saadetava teksti kodeering, kodeeritud pikkus ja SMS-segmentide arv. See lõpp-punkt ei saada SMS-i, ei broneeri marsruuti ega tagasta kohaletoimetamise hinnapakkumist. Esita kogu lõplik tekst, sealhulgas kõik jalused, lingid ja sõnumitest loobumise juhised, mille sinu saatmise töövoog lisab.

Päring

Autendi oma aktiveeritud API-konto ja sellele lubatud lähte-IP-aadressi abil. Hoia autentimisandmeid serveripoolses saladuste hoidlas. Saada UTF-8 kodeeringus string väljal text; näites kasutatakse keskkonnamuutujaid.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode 'text=Your message here' \
  https://api.multitel.net/v3/smslength

Toetatud on vormikodeeringus sisend. Ka JSON-objekt, näiteks {"text":"Your message here"} võetakse vastu, kui vormi- ega päringuparameetreid pole esitatud. Eelista meetodit POST, et sõnumi tekst ei ilmuks URL-is. Kui esitatud on nii vormi- kui ka päringuparameetrid, kasutatakse vormiandmeid. Ära sega päringuvorminguid.

Vastus

{
  "status": {
    "code": "200",
    "msg": ""
  },
  "response": {
    "charset": 0,
    "encoding": "GSM-7",
    "count": 1,
    "parts": 1,
    "chars": 17,
    "units": 17,
    "single_limit": 160,
    "multipart_limit": 153
  }
}

Kalkulaatori tulemuse väljad
Väli	Tähendus
charset	0 kodeeringu GSM-7 korral või 2 kodeeringu UTF-16 korral.
encoding	GSM-7 või UTF-16.
parts, count	Kaks nimetust arvutatud SMS-segmentide arvule. Tühja teksti korral on mõlema väärtus null.
units, chars	Kaks nimetust kodeeritud ühikute arvule. Need ei pruugi võrduda nähtavate märkide arvuga.
single_limit	Ühe segmendi kodeeritud ühikute piirarv valitud kodeeringu korral.
multipart_limit	Iga segmendi kodeeritud ühikute piirarv pärast segmentide ühendamiseks vajaliku lisamahu arvestamist.

Kodeering ja segmentide piirangud

Kalkulaatoris kasutatavad piirangud
Kodeering	Üksiksegment	Mitmeosalise sõnumi segment
GSM-7	160 septetti	153 septetti
UTF-16	70 koodiühikut	67 koodiühikut

Kodeeringu GSM-7 laiendusmärgid, näiteks ^, looksulud, nurksulud, kurakriips, püstkriips, tilde ja euromärk, võtavad kaks septetti. Märk, mida kodeering GSM-7 ei sisalda, lülitab kogu sõnumi ühikute loendamise kodeeringule UTF-16. Põhilisest mitmekeelsest tasandist väljapoole jääv emotikon kasutab kaht UTF-16 ühikut; nähtav emotikonijada võib sisaldada mitut koodipunkti.

Näiteks 160 tavalist GSM-7 tähte mahuvad ühte segmenti ja 161 vajavad kaht. Kaheksakümmend märki ^ kasutavad 160 ühikut ja mahuvad ühte segmenti; kaheksakümmend üks kasutavad 162 ühikut ja vajavad kaht. Kolmkümmend viis lihtsat BMP-välist emotikoni kasutavad 70 UTF-16 ühikut ja mahuvad ühte segmenti; kolmkümmend kuus kasutavad 72 ühikut ja vajavad kaht. Kombineeruvad märgid ja ühendatud emotikonid võivad neid arve muuta.

Vead ja tühi tekst

Puuduv väli text, skalaarväärtuse asemel esitatud massiiv või objekt või vigane UTF-8 tagastab API koodi 403. Loe JSON-vastuse välju status.code ja status.msg ning ka HTTP olekukoodi; see lõpp-punkt tagastab koodi stringina. Tühi string on lubatud ning selle korral tagastatakse null ühikut ja null segmenti.

Kasuta tulemust enne saatmist

Üle vaadatud kalkulaator ei saada sõnumeid, ei tee päringuid sideoperaatorile ega debiteeri kontot. Selle tulemus on esitatud teksti analüüs, mitte kohaletoimetamise garantii ega lõplik arve. Saatmisega võivad kaasneda sihtkohapõhised tariifid, sideoperaatori tasud, kampaanianõuded ja täiendavad tekstimuudatused. Arvuta tulemus pärast sõnumi muutmist uuesti ning kasuta seejärel heakskiidetud saatmise töövoogu ja konto kehtivat hinnakirja.