Sms-centru api

Trimiterea unui mesaj

Scrisoarea trebuie trimisă în text simplu cu codificarea specificată, implicit koi8-r. Codificarea este specificată în antetul Content-Type (Content-Type: text / plain; charset = "CHARSET"). Dimensiunea maximă a mesajului este de 100 KB.

Descrierea parametrilor transmiși către server:

Parola de client sau parola MD5 hash în litere mici.

ID-ul mesajului. Numit de Client. Ea servește pentru a identifica în continuare mesajul. Dacă nu este specificat, acesta va fi atribuit în mod automat. Nu este neapărat unic. ID-ul este un număr de 32 de biți, în intervalul de la 1 la 2147483647, sau un șir de până la 40 de caractere formate din litere, cifre și simboluri „-_“.

Un semn că mesajul trebuie tradus în translit.
0 (implicit) - nu se traduce în translit.
1 - traduce în transliterare ca "translit".
2 - traduceți în transliterație sub forma "mpaHc / Ium".

Reduceți automat linkurile din mesaje. Vă permite să înlocuiți linkurile din textul mesajului cu cele scurte pentru a scurta lungimea și pentru a urmări numărul de tranziții de pe această pagină.
0 (implicit) - lăsați linkurile în textul mesajului neschimbate.
1 - scurtați legăturile.

Fusul orar în care este specificat parametrul de timp. Indică timpul Moscovei. Parametrul tz poate fi pozitiv sau negativ. Dacă tz este 0, fusul orar al Moscovei va fi folosit, dar dacă tz nu este specificat, fusul orar va fi luat din setările Clientului.

Indică necesitatea de a trimite o scrisoare de răspuns cu rezultatul trimiterii unui mesaj SMS. Dacă este 0 sau nu este specificat, atunci răspunsul este trimis numai dacă există o eroare în parametri, dacă 1, atunci răspunsul este trimis în orice caz. Parametrul este utilizat pentru depanarea în timpul configurării inițiale a serviciului.


Parametrii ar trebui să meargă strict în ordinea dată. Necesare sunt login. PSW. telefoane și mes. Dacă nu există parametru opțional, colonul trebuie să rămână.

Exemplul (. câmp

Într-un câmp compus , , , orice parametru poate lipsi, păstrând virgula de început.

alex: psw. 1.1, Alex: 79999999999: mesaj
alex: psw. 1: 79999999999: mesaj
alex: psw. , 1: 79999999999: mesaj
alex: psw. , 1, Alex: 79999999999: mesaj
alex: psw. , 1 ,, 1: 79999999999: mesaj

Pentru a trimite diferite tipuri de mesaje, puteți utiliza abilitatea de a specifica prefixe speciale la început sau în loc de textul mesajului.

Trimiterea unui mesaj vocal (apel). Când trimiteți un mesaj vocal la sfârșitul textului, puteți specifica o combinație specială de "\ n

\ n "(feedul de linie, 3 caractere tilde și din nou feed-ul de linie), urmată de parametrul param, care definește anumite caracteristici ale apelului (pentru mai multe detalii, consultați descrierea).

Trimiterea unui mesaj către utilizatorii mesageriei instant Viber.

Cerere HLR pentru primirea informațiilor despre numărul din baza de date a operatorului fără a trimite un SMS real.

Dacă a apărut o eroare în parametri sau sa produs o altă eroare și parametrul de testare a fost interogat, acesta va fi următorul:
  • EROARE = ​​N (descriere) - pentru erorile 1,2,4,5,9;
  • ERROR = N (descriere), ID - - pentru erori 3,6,7,8.
  • N - numărul de eroare, poate lua următoarele valori:

    Eroare în parametri.

    Mesajul către numărul specificat nu poate fi livrat.

    Trimiterea mai multor solicitări identice pentru a trimite un mesaj SMS în decurs de un minut.


    Dacă mesajul este primit cu succes și răspunsul este solicitat, parametrul de testare returnează următorul șir:
    • OK - SMS, ID -
    în cazul în care:
    Este numărul de SMS expediate, calculat ca număr de SMS în mesaj, înmulțit cu numărul de destinatari.
    - identificatorul mesajului trimis de Client sau atribuit automat de Server.

    Serverul nu ia mai mult de două cereri identice pentru a trimite mesaje SMS în câteva minute pentru a proteja împotriva bug-uri și looping într-un program de pe partea de client, în scopul de a reduce sarcina și nu cheltui banii Clientului, precum și pentru a preveni trimiterea mesajelor repetate la un singur abonat.

    Serverul dezactivează, de asemenea, trimiterea de mai mult de 50 de mesaje către un abonat, care a fost trimis cu un interval între mesaje cu mai puțin de 2 minute, pentru a proteja împotriva inundațiilor și a excesului de debitând contul Clientului, cât mai mulți operatori nu permit un număr mare de mesaje pe care un singur utilizator într-o perioadă scurtă de timp .

    Trimiterea unei solicitări HLR

    Pentru a trimite o solicitare HLR, utilizați comanda de trimitere obișnuită SMS, specificând un format egal cu 3. Parametru textul mesajului nu este utilizat și poate fi gol. Rezultatul cererii poate fi recepționat prin protocolul HTTP prin apel automat al operatorului sau solicită independent starea mesajului SMS trimis printr-o comandă specială. Deoarece cererea HLR este executată asincron și rezultatul nu poate reveni imediat de la operator, este important să faceți un ciclu de mai multe iterații cu adormire (comanda de somn) pentru o solicitare independentă de stare.