Question 1

Izmantojot HTTP API versiju 0.16 (pašreizējā)

Accepted Answer

Izmaiņas kopš iepriekšējās versijas (0.15):

Vienkāršota ziņojumu izsūtīšana, apvienojot visas sūtīšanas pieprasījuma metodes vienotā Send metodē.
Send metodi tagad var izmantot, lai pēc kopīga šablona nosūtītu personalizētu saturu katram adresātam.
Send pievienots parametrs Transliteration, automātiskai Unicode rakstzīmju pārveidošanai uz atbilstošākajām GSM alfabēta vienībām.
No Send metodes noņemti parametri Concatenated un Unicode, jo tiem bija ierobežots pielietojums (kļūdas atgriešana noteiktos apstākļos), radīja neskaidrības attiecībā uz pieprasījumu ieviešanu un to iekļaušana Send metodē nebūtu praktiska. Ja paļāvāties uz šo funkcionalitāti, piekodinām, ka pieprasījumi, kuri šo parametru dēļ iepriekš būtu noraidīti, turpmāk tiks veiksmīgi izpildīti.
MSSID parametrs, kas norāda uz viena ziņojuma identifikatoru pieprasījumos un atbildēs, ir pārdēvēts par, vienkārši, ID.
InvalidCC kļūdas kods skaidrības labad ir pārdēvēts par InvalidCountryCode.
Piegādes atskaitēm pievienots nepiegādāto ziņojumu statuss Expired.
Autentiskuma nodrošināšanai Izmantota HMAC autentifikācija, lai parakstītu piegādes ziņojumu webhook pieprasījumus.

pēc palaiša

Question 2

SMS saturs un garums

Accepted Answer

Cik gara drīkst būt viena SMS?

Īsziņas garums ir atkarīgs no tās satura. Ja SMS satur tikai GSM alfabētā norādītās rakstzīmes - latīņu lielos un mazos burtus, ciparus, pieturzīmes un dažus diakritiskos simbolus, tās garums var būt līdz 160 rakstzīmēm (tādi simboli kā, piemēram, euro simbols €, kvadrātiekavas [ ], figūriekavas { }, slīpsvītra \, jumtiņš ^, vertikālā līnija | aizņem 2 vietas, tādēļ ikreiz izmantojot šos simbolus atlikušo rakstzīmju skaits samazinās par 2.

Ar šo lielākoties ir gana, ja īsziņa rakstīta valodā, kuru papildu diakritiskie simboli arī iekļaujas GSM alfabētā, piemēram, angļu vai somu.

Taču lielākoties ar šīm rakstzīmēm nepietiek un tādos gadījumos tiek pielietots Unicode kodējums, kas ļauj izmantot gandrīz visas rakstzīmes, samazinot kopējo SMS garumu līdz 70 simboliem.

Garākas īsziņas

Garākas īsziņas ir iespējamas un tiek lietotas ļoti bieži. Tas tiek panākts ar tā saukto vairākdaļu īsziņu, kas būtībā ir vairākas parastas SMS ar pievienotu norādi par to, kā telefonam tās sakārtot, lai lietotājs to var izlasīt kā vienu garu īsziņu, tomēr šī indikatora pievienošanai ir zināma ietekme uz SMS garumu; ja īsziņa satur GSM alfabēta simbolus, tad vienas daļas maksimālais rakstzīmju skaits ir 153, nevis 160. Unicode īsziņas gadījumā - 67 rakstzīmes 70 vietā. Garā īsziņa ar 3 daļām var būt attiecīgi 459 vai 201 r

Question 3

API pieprasījumi izmantojot cURL

Accepted Answer

Sniegtie piemēri balstās uz pašreizējo API versiju (0.15), taču iepriekšējās versijas ir pietiekoši līdzīgas un izmaiņas komandās nav būtiski atšķirīgas.

cURL --data* parametri automātiski iestata Content-Type galveni uz nepieciešamo application/x-www-form-urlencoded, tādēļ piemēros tas netiek atspoguļots. Ja nepieciešams, to iespējams iestatīt izmantojot -H parametru.

SendOne

Nosūta vienu īsziņu vienā API pieprasījumā.

Pieprasījums:

curl -X POST https://traffic.sales.lv/API:0.15/ \ --data-urlencode "APIKey=YOURAPIKEY" \ --data-urlencode "Command=SendOne" \ --data-urlencode "Number=37199999999" \ --data-urlencode "Sender=YOURNAME" \ --data-urlencode "Content=Hello there"

Vēlamā atbilde:

  "MSSID":"123456789012",
  "CC":"371",
  "Phone":"99999999",
  "Length":"1",
  "Unicode":"0",
  "LongSMS":"0",
  "Invalid":false,
  "Network":"LMTLV",
  "Validity":1440
}```
##### Kļūdas atbilde:

{ "Error":"InvalidNumber" }```

SendMultiple

Nosūta vairākas īsziņas vienā API pieprasījumā.

Pieprasījums:

curl -X POST https://traffic.sales.lv/API:0.15/ \ --data-urlencode "APIKey=YOURAPIKEY" \ --data-urlencode "Command=SendMultiple" \ --data-urlencode "Sender=YOURNAME" \ --data-urlencode "Content=[[\"+37112341234\"\,"Lorem ipsum dolor sit amet\"],[\"+37198769876","consectetur adipscing elit.\"]]\"

Vēlamā atbilde:

```{ "37112341234": { "MSSID":"123456789012", "CC":"371", "Phone":"99999999", "Content":"Lorem ipsum d

Question 4

Piegādes atskaišu saņemšana, izmantojot webhook

Accepted Answer

Konta iestatījumos varat norādīt HTTP(S) adresi priekš "webhook", kas mūsu pusē tiks izsaukts ikreiz, kad parādīsies jauna piegādes atskaite ziņojumam, kas nosūtīts caur jūsu API kontu.

|| Atkarībā no Jūsu ugunsmūra iestatījumiem, varētu būt noderīgi pievienot mūsu IP adreses izņēmumiem (whitelist), lai šo pieprasījumu saņemšana vienmēr būtu veiksmīga.

Uz klienta norādīto adresi atskaites tiks piegādātas kā HTTP POST pieprasījumi ar šiem parametriem:

MSSID: SMS ID, kāds tika saņemts no SendOne vai AddBatchRecipients komandām.
DLR: piegādes statuss ar vienu no šīm vērtībām: - Delivered: SMS piegādāta. - Sent: SMS nosūtīta, bet nav zināms vai saņemta (vārteja nav nodevusi DLR). - Buffered: SMS nodota piegādei, bet stāv rindā. - Undelivered: SMS nav izdevies piegādāt. - Error: sistēmas vai vārtejas kļūda. - Other: cita, neatpazīta piegādes atskaite. Error un Other statusiem normālos apstākļos nevajadzētu atgadīties vispār.
Expired (0/1): Ja īsziņa netika piegādāta (atskaitē parādās statuss __Undelivered __), šis statuss precizēs to vai tas bija īsziņas noilguma iestāšanās dēļ (saņēmēja tālruņa numurs ir derīgs, bet īsziņas derīguma termiņa periodā nebija sasniedzams)
HMAC: Autentifikācijas kods ziņojumu pārbaudei.

Sīkāku informāciju par konkrēto piegādes statusu nozīmi varat atrast šeit: [SMS piegādes statusu skaidrojums](https://help.sales.lv/lv/article/sms-piegades

Question 5

SMS piegādes statusu skaidrojums

Accepted Answer

Nosūtot SMS ziņojumus, mēs sniedzam pārskatu par īsziņu piegādes statusu, kurš parāda veiksmīgi piegādāto, nepiegādāto vai procesā esošo (vēl nepiegādāto) īsziņu skaitu. Šī raksta mērķis ir vēl smalkāk izskaidrot katra statusa nozīmi.

Piegādātas

Īsziņas ar šo statusu liecina par to, ka tās ir padotas operatoram un veiksmīgi nogādātas saņēmēju tālruņos. Atskaite ar šo statusu norāda uz īsziņas saņemšanu lietotāja telefonā, taču ir daži izņēmumi, piemēram, Amerikas Savienotās Valstis, Kanāda un citas valstis, kurās šis statuss norāda uz veiksmīgu īsziņas nodošanu mobilajam operatoram. Eiropā, Āzijā, Āfrikā, Dienvidamerikā šis statuss tomēr liecina par to, ka īsziņa ir nogādāta līdz saņēmēja tālrunim.

Ja saņemta atskaite ar šo piegādes statusu, taču lietotājs apgalvo, ka īsziņu nav saņēmis, ir ļoti liela varbūtība, ka problēma ir saņēmēja pusē: bloķēts ziņotājs, SMS saziņas aplikāciju spama filtri, izslēgti paziņojumi vai pat tālruņa programmatūras kļūmes.

Procesā

Šis statuss parādās, ja īsziņa ir izsūtīta, taču vēl nav saņemts statuss par veiksmīgu piegādi. Gadījumos kad mobīlā tīkla operators nav spējīgs uzreiz sasniegt saņēmēju, šis statuss var parādīties samērā ilgi - kamēr operators mēģina īsziņu piegādāt atkārtoti, līdz brīdim kad iestājas īsziņas noilgums. Visbiežākie iemesli:

Izslēgts tālrunis;
Tālrunis atrodas ārpus uztveršanas zonas;
Tālruņa atmiņa ir pilna (viedtālruņu laikmetā retāk sastopama problēma);
Priekšapmaksas kartes atlikums ir iztērēt

Question 6

Izmantojot HTTP API versiju 0.15

Accepted Answer

|| Šī versija ir aizstāta ar jaunāku - API 0.16 versiju. API 0.15 būs pieejama, atbalstīta un pilnībā funkcionāla, un arī turpmāk tā saņems kļūdu labojumus, taču tajā netiks ieviesta jauna funkcionalitāte.

Iesākumam

Q: Izmantojot HTTP API versiju 0.15

<p>|| Šī versija ir aizstāta ar jaunāku - <a href="https://help.sales.lv/en/article/using-http-api-version-016-current-1qaogrt/">API 0.16 versiju</a>. API 0.15 būs pieejama, atbalstīta un pilnībā funkcionāla, un arī turpmāk tā saņems kļūdu labojumus, taču tajā netiks ieviesta jauna funkcionalitāte. </p> <h1 id="ieskumam">Iesākumam</h1> <p>Informācija, kas nepieciešama jūsu konta un API piekļuves aktivizēšanai, ir:</p> <ul> <li>jūsu servera IP adrese (ir iespējamas vairākas adreses, aizstājējzīmes (wildcard substitution) un apakštīkli (subnets). </li> <li>HTTP adrese priekš "webhook", uz kuru pārsūtīt īsziņu piegādes pārskatus. Ja piegādes atskaites nav nepieciešamas, šo adresi var izlaist.</li> </ul> <p>Pēc šīs informācijas saņemšanas mēs iedosim Jums API atslēgu, ko var izmantot SMS padošanai.</p> <p>Piezīme - ja Jums ir vairākas vides, no kurām vēlaties sūtīt SMS, piemēram, izstrādes/testa vide un produkcijas vide, katrai no tām būs nepieciešams atsevišķs API konts un atsevišķa API atslēga.</p> <h1 id="visprgasmsinformcija">Vispārīga SMS informācija</h1> <p>Standarta SMS garums ir 160 GSM alfabēta simboli (aprakstīts šeit - <a href="https://help.sales.lv/lv/article/sms-saturs-un-garums-1b0ie2q/">SMS saturs un garums</a>). Garākas SMS ir iespējamas, sūtot tās atsevišķās daļās, kas saņēmēja galā tiek apvienotas vienā SMS, taču katra no šīm daļām tiks uzrādīta rēķinā kā atsevišķa SMS. Tomēr sūtot vairākdaļu SMS, katra atsevišķā daļa ir nedaudz īsāka nekā viena SMS - viena daļa var būt līdz 153 simbolus gara, piemēram, 160 simbolu SMS var tikt nosūtīta kā viendaļīga SMS, taču 170 simbolu SMS tiks nosūt</p>

Informācija, kas nepieciešama jūsu konta un API piekļuves aktivizēšanai, ir:

jūsu servera IP adrese (ir iespējamas vairākas adreses, aizstājējzīmes (wildcard substitution) un apakštīkli (subnets).
HTTP adrese priekš "webhook", uz kuru pārsūtīt īsziņu piegādes pārskatus. Ja piegādes atskaites nav nepieciešamas, šo adresi var izlaist.

Pēc šīs informācijas saņemšanas mēs iedosim Jums API atslēgu, ko var izmantot SMS padošanai.

Piezīme - ja Jums ir vairākas vides, no kurām vēlaties sūtīt SMS, piemēram, izstrādes/testa vide un produkcijas vide, katrai no tām būs nepieciešams atsevišķs API konts un atsevišķa API atslēga.

Vispārīga SMS informācija

Standarta SMS garums ir 160 GSM alfabēta simboli (aprakstīts šeit - SMS saturs un garums). Garākas SMS ir iespējamas, sūtot tās atsevišķās daļās, kas saņēmēja galā tiek apvienotas vienā SMS, taču katra no šīm daļām tiks uzrādīta rēķinā kā atsevišķa SMS. Tomēr sūtot vairākdaļu SMS, katra atsevišķā daļa ir nedaudz īsāka nekā viena SMS - viena daļa var būt līdz 153 simbolus gara, piemēram, 160 simbolu SMS var tikt nosūtīta kā viendaļīga SMS, taču 170 simbolu SMS tiks nosūt

Biežāk lasītie raksti

Aplūkot visas kategorijas