Изпращане на кратко текстово съобщение (SMS) към мобилен номер

Обхват на услугата

Актуалното покритие по държави и оператори е следното:

България

Operator	Country Code	Prefixes	MNC	NC	Notes
A1 (Mobiltel, M-Tel, Citron)	359	88, 988, 989	284	01
Telenor (Globul)	359	89	284	05
Vivacom (Vivatel)	359	87	284	03

Изпращане на съобщение

API Endpoint URL

https://api.netfinity.bg/v2/sms/notification/send

Входни параметри

Parameter	Meaning	Notes
msisdn	Мобилен номер на получател	Формат: Е164 /препоръчително/, 00 + Е164, национален (1)
text	Текст на латиница с дължина до 160 символа (2)	GSM 03.38, като символите с двойно кодиране се конвертират до аналози с 1 байт
id	alphanum	Вашият идентификатор на съобщение

1. При подаване на номер в национален формат се подразбира, че номерът на получателя е в държавата за която е съответната услуга
2. В началото на съобщението се добавя вашият префикс и всички символи след 160-ият се изрязват

Пример:

{
    "msisdn":"359881234567",
    "text":"test 1",
    "id": "123"
}

Параметърът id не е задължителен, но е препоръчително да присъства за да бъде включена стойността му във всички следващи пакети, които изпращаме.

Отговор на заявката

Info

Списък на всички възможни изходни кодове и тяхното значение прочетете тук.

При успешно валидиране на входните данни, заявката се приема за последваща асинхронна обработка. Ще получите изходен код (200) и следният отговор:

{
    "uuid": "...",
    "id": "...",
    "status": [
        "code": 200,
        "description": "Request accepted"
    ]
}

uuid е нашият идентификатор на заявката, по който ще получавате допълнителна информация за състоянието на съобщението.