Този документ предоставя справка за всички функции, достъпни за Вас чрез HTTP интерфейса за изпращане на текстови съобщения.
HTTP API-то Ви позволява да интегрирате Вашето приложение с easysms (портал) чрез използване на HTTP протокола за изпращане на съобщения. HTTPS се поддържа специфично за всички транзакции, използващи SSL криптиране.
Обща информация
Клиентът изпраща HTTP GET заявка към easysms HTTP интерфейса, предоставяйки списък с необходими параметри. easysms връща обратно HTTP отговор, който показва успеваемостта на транзакцията
Обърнете внимание, че разделителя '|', използван в много случаи по-долу във върнатата информация, е символа за вертикална черта (ASCII 124). Моля, не забравяйте да шифровате за URL всички подадени параметри.
омандите, достъпни в тази версия на API-то на easysms следват по-долу.
Изпращане на SMS
URL: https://www.net2sms.gr/srvauth/index?cmd=easysms&action=send_sms
Приемани параметри
| Параметър | Описание | Наличност |
|---|---|---|
text |
Съобщение за изпращане. Трябва да е шифровано за URL. | Задължително |
mobile_number |
MSIDSN на получателя, на когото съобщението ще бъде изпратено. Например: 49175123456 | Задължителен |
originator |
ID на подателя (ако е буквено-числов - максимум 11 символа, ако е числов - максимум 16 символа) | Незадължителен |
flash |
Задайте като вярно, за да изпратите Флаш съобщение | Незадължителен |
request_delivery |
Задайте като вярно, за да получите отчет за доставка | Незадължителен |
Връща
код на върнатото | sms_id | баланс
| Описание | |
|---|---|
Код на върнатото |
1 за изпратено съобщение, в противен случай изпращането неуспешно |
ID на текстовото съобщение |
ID-то на съобщението, отчетите за доставка са дадени според ID-тата на съобщенията |
баланс |
баланса на акаунта |
Примерна заявка за изпращане на текстово съобщение
За да напишете 'Hello, World!' на '49175123456', показано като изпратено от 'МоятаКомпания', трябва да използвате:
https://www.net2sms.gr/srvauth/index?cmd=easysms&action=send_sms&text=Hello%20World&mobile_number=49175123456&originator=MyCompany
Порталът ще върне нещо от сорта на:
1|456123789|112
Което се превежда като текстово съобщение е успешно зададено с ID 456123789 и Вашият баланс е 112