Analizējiet precīzu ziņojuma tekstu
Aprēķiniet kodējumu, kodētā teksta garumu un SMS segmentu skaitu tekstam, kuru plānojat nosūtīt. Šis galapunkts nenosūta SMS, nerezervē maršrutu un neatgriež piegādes cenas piedāvājumu. Iesniedziet visu galīgo tekstu, tostarp jebkuru kājeni, saiti vai atteikšanās tekstu, ko pievieno jūsu nosūtīšanas darbplūsma.
Pieprasījums
Autentificējieties, izmantojot savu aktivizēto API kontu un tam atļauto avota IP adresi. Glabājiet akreditācijas datus servera puses slepeno datu glabātuvē. Laukā text nosūtiet virkni ar UTF-8 kodējumu; piemērā tiek izmantoti vides mainīgie.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--data-urlencode 'text=Your message here' \
https://api.multitel.net/v3/smslengthTiek atbalstīti veidlapas formātā kodēti ievaddati. Arī JSON objekts, piemēram, {"text":"Your message here"} tiek pieņemts, ja nav norādīti veidlapas vai vaicājuma lauki. Dodiet priekšroku POST, lai ziņojuma teksts neparādītos URL adresē. Ja ir norādīti gan veidlapas, gan vaicājuma ievaddati, tiek izmantota veidlapa. Nejauciet pieprasījumu formātus.
Atbilde
{
"status": {
"code": "200",
"msg": ""
},
"response": {
"charset": 0,
"encoding": "GSM-7",
"count": 1,
"parts": 1,
"chars": 17,
"units": 17,
"single_limit": 160,
"multipart_limit": 153
}
}| Lauks | Nozīme |
|---|---|
| charset | 0, ja kodējums ir GSM-7, vai 2, ja kodējums ir UTF-16. |
| encoding | GSM-7 vai UTF-16. |
| parts, count | Divi nosaukumi aprēķinātajam SMS segmentu skaitam. Ja teksts ir tukšs, abas vērtības ir nulle. |
| units, chars | Divi nosaukumi kodējuma vienību skaitam. Tas ne vienmēr sakrīt ar redzamo rakstzīmju skaitu. |
| single_limit | Kodējuma vienību ierobežojums vienam segmentam ar izvēlēto kodējumu. |
| multipart_limit | Kodējuma vienību ierobežojums katram segmentam pēc segmentu savienošanai nepieciešamā papildu apjoma atskaitīšanas. |
Kodējums un segmentu ierobežojumi
| Kodējums | Viens segments | Vairākdaļu ziņojuma segments |
|---|---|---|
| GSM-7 | 160 septeti | 153 septeti |
| UTF-16 | 70 koda vienības | 67 koda vienības |
GSM-7 paplašinājuma rakstzīmes, piemēram, ^, figūriekavas, kvadrātiekavas, atpakaļvērstā slīpsvītra, vertikālā svītra, tilde un eiro zīme, aizņem divus septetus. Rakstzīme, kas neietilpst GSM-7, pārslēdz visa ziņojuma uzskaiti uz UTF-16 kodējumu. Emocijzīme ārpus pamata daudzvalodu plaknes aizņem divas UTF-16 vienības; redzama emocijzīmju secība var saturēt vairākus koda punktus.
Piemēram, 160 parasti GSM-7 burti ietilpst vienā segmentā, bet 161 burtam nepieciešami divi. Astoņdesmit ^ rakstzīmes aizņem 160 vienības un ietilpst vienā segmentā; astoņdesmit viena aizņem 162 vienības, un tām nepieciešami divi segmenti. Trīsdesmit piecas vienkāršas emocijzīmes ārpus pamata daudzvalodu plaknes (BMP) aizņem 70 UTF-16 vienības un ietilpst vienā segmentā; trīsdesmit sešas aizņem 72 vienības, un tām nepieciešami divi segmenti. Kombinējošās zīmes un savienotas emocijzīmes var mainīt šos skaitļus.
Kļūdas un tukšs teksts
Ja trūkst lauka text, skalāras vērtības vietā ir masīvs vai objekts vai UTF-8 kodējums nav derīgs, tiek atgriezts API kods 403. Pārbaudiet gan JSON laukus status.code un status.msg, gan HTTP statusu; šis galapunkts atgriež kodu kā virkni. Tukša virkne ir derīga, un tai tiek atgriezts nulle vienību un nulle segmentu.
Izmantojiet rezultātu pirms nosūtīšanas
Pārbaudītais kalkulators neveic ziņojuma nosūtīšanu, izsaukumu operatoram vai naudas norakstīšanu no konta. Tā rezultāts ir iesniegtā teksta analīze, nevis piegādes garantija vai galīgais rēķins. Nosūtīšanai var tikt piemēroti galamērķa tarifi, operatora maksas, kampaņu prasības un papildu teksta pārveidojumi. Pēc ziņojuma mainīšanas veiciet aprēķinu atkārtoti, pēc tam izmantojiet apstiprināto nosūtīšanas darbplūsmu un pašreizējos konta tarifus.