Analizoni tekstin e saktë të mesazhit
Llogaritni kodimin, gjatësinë e koduar dhe numrin e segmenteve SMS për tekstin që synoni të dërgoni. Kjo pikë fundore nuk dërgon SMS, nuk rezervon rrugë dërgimi dhe nuk kthen ofertë çmimi për dorëzimin. Paraqitni tekstin e plotë përfundimtar, duke përfshirë çdo shënim në fund, lidhje ose formulim për çregjistrimin nga marrja e mesazheve që shton rrjedha juaj e punës për dërgimin.
Kërkesa
Autentikohuni duke përdorur llogarinë tuaj të aktivizuar të API-së dhe adresën IP të burimit të lejuar për të. Ruajini kredencialet në një depo sekretesh në anën e serverit. Dërgoni një varg UTF-8 në fushën text; shembulli përdor variabla të mjedisit.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--data-urlencode 'text=Your message here' \
https://api.multitel.net/v3/smslengthMbështeten të dhënat hyrëse të koduara si formular. Një objekt JSON si {"text":"Your message here"} pranohet gjithashtu kur nuk jepen fusha formulari ose parametra të vargut të kërkimit. Parapëlqeni POST që teksti i mesazhit të mos shfaqet në një URL. Nëse janë të pranishme si të dhënat e formularit, ashtu edhe ato të vargut të kërkimit, përdoret formulari. Mos i përzieni formatet e kërkesës.
Përgjigjja
{
"status": {
"code": "200",
"msg": ""
},
"response": {
"charset": 0,
"encoding": "GSM-7",
"count": 1,
"parts": 1,
"chars": 17,
"units": 17,
"single_limit": 160,
"multipart_limit": 153
}
}| Fusha | Kuptimi |
|---|---|
| charset | 0 për GSM-7 ose 2 për UTF-16. |
| encoding | GSM-7 ose UTF-16. |
| parts, count | Dy emra për numrin e llogaritur të segmenteve SMS. Të dy kanë vlerën zero për tekst bosh. |
| units, chars | Dy emra për njësitë e koduara. Ato nuk përputhen domosdoshmërisht me karakteret e dukshme. |
| single_limit | Kufiri i njësive të koduara për një segment të vetëm me kodimin e zgjedhur. |
| multipart_limit | Kufiri i njësive të koduara që përdoret për çdo segment pasi merret parasysh hapësira shtesë e nevojshme për bashkimin e segmenteve. |
Kodimi dhe kufijtë e segmenteve
| Kodimi | Segment i vetëm | Segment i një mesazhi me disa pjesë |
|---|---|---|
| GSM-7 | 160 septete | 153 septete |
| UTF-16 | 70 njësi kodi | 67 njësi kodi |
Karakteret e zgjerimit të GSM-7, si ^, kllapat gjarpërore, kllapat katrore, vija e pjerrët e kundërt, vija vertikale, tilda dhe shenja e euros, zënë dy septete. Një karakter jashtë GSM-7 bën që i gjithë mesazhi të numërohet sipas UTF-16. Një emoji jashtë planit bazë shumëgjuhësh përdor dy njësi UTF-16; një sekuencë e dukshme emoji-sh mund të përmbajë disa pika kodi.
Për shembull, 160 shkronja të zakonshme GSM-7 zënë një segment dhe 161 kërkojnë dy. Tetëdhjetë karaktere ^ përdorin 160 njësi dhe zënë një segment; tetëdhjetë e një përdorin 162 njësi dhe kërkojnë dy. Tridhjetë e pesë emoji të thjeshta jashtë BMP-së përdorin 70 njësi UTF-16 dhe zënë një segment; tridhjetë e gjashtë përdorin 72 njësi dhe kërkojnë dy. Shenjat kombinuese dhe emoji-t e bashkuara mund t'i ndryshojnë këto numërime.
Gabimet dhe teksti bosh
Mungesa e fushës text, një varg elementesh/objekt në vend të një vlere skalare ose një kodim UTF-8 i pavlefshëm kthen kodin 403 të API-së. Lexoni fushat JSON status.code dhe status.msg, si edhe statusin HTTP; kjo pikë fundore e kthen kodin si varg karakteresh. Një varg karakteresh bosh është i vlefshëm dhe kthen zero njësi dhe zero segmente.
Përdoreni rezultatin përpara dërgimit
Llogaritësi i shqyrtuar nuk përmban asnjë veprim për dërgimin e mesazheve, thirrje ndaj operatorit ose debitim të llogarisë. Rezultati i tij është një analizë e tekstit të paraqitur, jo një garanci dorëzimi ose një faturë përfundimtare. Dërgimi mund të përfshijë tarifa sipas destinacionit, tarifa të operatorit, kërkesa të fushatës dhe transformime shtesë të tekstit. Rillogaritni pasi ta ndryshoni mesazhin, pastaj përdorni rrjedhën e miratuar të punës për dërgimin dhe çmimet aktuale të llogarisë.