Trimiterea parametrilor de mai jos spre SMS Gateway se poate face ca parametru prin metoda GET (in format URL Encoded) sau ca parametrii de tip POST.
Parametru | Descriere |
connection_id | (Obligatoriu) Connection ID-ul este ID-ul conexiunii create in sectiunea SMS Gateway - Configurare si setari |
password | (Obligatoriu) Parola este parola asociata Connection ID-ului creat in sectiunea SMS Gateway - Configurare si setari |
to |
(Obligatoriu) Numarul de telefon mobil al destinatarului. Va recomandam sa utilizati formatul standard national, ex. 07xyzzzzzz. Sunt acceptate urmatoarele formate de numar de telefon: 07xyzzzzzz (format standard national), 00407xyzzzzzz (format international), +407xyzzzzzz (format international), 7xyzzzzzz (format national, fara zero in fata). Aflati mai multe despre despre formatul acceptat pentru numerele de telefon si despre alte optiuni disponibile. |
message |
(Obligatoriu) Textul mesajului pe care il transmiteti. Mesajul trebuie sa contina cel putin 1 caracter. SMS-urile pot sa contina maxim 160 de caractere pentru a fi taxate ca un singur SMS. Puteti transmite SMS-uri mai lungi de 160 de caractere ca un singur mesaj concatenat sau ca mesaje separate, in functie de setarile din sectiunea SMS Gateway - Configurare si setari. SMS-urile concatenate mai lungi de 160 de caractere se vor taxa ca SMS-uri multiple, multiplu de 152 de caractere - 8 caractere fiind necesare pentru concatenarea SMS-urilor. Conform standardului GSM 7-bit IA5, urmatoarele caractere vor ocupa spatiul a 2 caractere: [, ], {, }, |, ^, ~, ", `, , CR (Carriage Return), LF (Line Feed). |
sender |
(Optional) Eticheta de transmitere a SMS-ului (senderul personalizat) sau numarul scurt de la care va fi expediat SMS-ul. Daca parametrul sender nu este specificat, acesta va fi initializat automat cu valoarea implicita "numeric", iar astfel SMS-ul se va transmite de la un numar scurt de forma 17xy / 18xy, conform reglementarilor ANCOM. Senderele personalizate se activeaza in prealabil, astfel inainte de a-l utiliza acesta trebuie sa fie activat in prealabil de SMSLink si de catre operatorii de telefonie mobila. Pentru activarea unui sender personalizat este necesar sa completati formularul pentru activarea unui sender personalizat din contul dvs. de utilizator sau sa ne contactati. |
mode | (Optional) Valoarea acestui parametru este optionala si se initializeaza implicit cu valoarea send pentru a transmiterea de SMS-uri, caz in care parametrii to si message devin obligatorii. Daca valoarea transmisa pentru acest parametru este credit, SMS Gateway va returna creditul SMS disponibil in contul de utilizator. |
timestamp |
(Optional) Data si ora in format UNIX timestamp la care doriti sa se trimita SMS-ul, in situatia in care nu doriti ca acesta sa se trimita instant.
|
test | (Optional) Valorile posibile pot sa fie 0 sau 1. Daca parametrul nu este transmis, el este initializat implicit cu valoarea 0.
|
message_type | (Optional) Daca parametrul nu este transmis, se initializeaza automat cu valoarea 1, reprezentand un SMS TEXT. Parametrul poate avea urmatoarele valori posibile.
|
udh | (Optional) UDH (User Data Headers) este un parametru optional, ce poate fi modificat doar daca message_type are valorile 2 sau 3 (pentru SMS WAP Push). |
Exemple de apelare a SMS Gateway prin metoda GET
Transmiterea unui SMS, instant catre numarul de mobil 0723123456, fara sender personalizat:
https://secure.smslink.ro/sms/gateway/communicate/?connection_id=[valoare]&password=[valoare]&to=0723123456&message=[valoare]
Transmiterea unui SMS, instant catre numarul de mobil 0723123456, cu sender personalizat:
https://secure.smslink.ro/sms/gateway/communicate/?connection_id=[valoare]&password=[valoare]&to=0723123456&message=[valoare]&sender=[valoare]
Transmiterea unui SMS, la o anumita data catre numarul de mobil 0723123456, fara sender personalizat:
https://secure.smslink.ro/sms/gateway/communicate/?connection_id=[valoare]&password=[valoare]&to=0723123456&message=[valoare]×tamp=[valoare]
Transmiterea unui SMS, la o anumita data catre numarul de mobil 0723123456, cu sender personalizat:
https://secure.smslink.ro/sms/gateway/communicate/?connection_id=[valoare]&password=[valoare]&to=0723123456&message=[valoare]&sender=[valoare]×tamp=[valoare]
Transmiterea unui SMS WAP Push, in format HEX catre numarul de mobil 0723123456:
https://secure.smslink.ro/sms/gateway/communicate/?connection_id=[valoare]&password=[valoare]&to=0723123456&message=DC0601AE02056A0045C60C037777772E736D736C696E6B2E726F000103534D534C696E6B000101&sender=[valoare]&message_type=2
Transmiterea unui SMS WAP Push, in format encapsulat catre numarul de mobil 0723123456:
https://secure.smslink.ro/sms/gateway/communicate/?connection_id=[valoare]&password=[valoare]&to=0723123456&message=www.smslink.ro|SMSLink&sender=[valoare]&message_type=3
Interogarea numarului de SMS-uri disponibile in contul de utilizator:
https://secure.smslink.ro/sms/gateway/communicate/?connection_id=[valoare]&password=[valoare]&mode=credit
Cuvantul valoare aflat intre paranteze drepte in exemplele de mai sus trebuie inlocuit cu o valoare corespunzatoare conform explicatiilor din tabelul de mai sus. De exemplu parametrul &message=[valoare] va deveni &message=Salut.
Daca spre exemplu doriti sa trimiteti 2000 SMS-uri folosind serviciul SMS Gateway apeland spre exemplu un cron job in fiecare minut, care citeste destinatarii din baza dv. de date si face 100 de apelari catre SMS Gateway (fiind nevoie in total de 20 de cron job-uri), nu porniti urmatorul cron job pana cand cel anterior nu a fost finalizat pentru a nu trimite de mai multe ori acelasi SMS.
Inregistrati-va si testati gratuit toate serviciile SMSLink