Асинхронна відправка повідомлень

Приклад запиту на асинхронну відправку повідомлень. Великий пакет повідомлень може бути відправлений асинхронно. Система приймає всі повідомлення для відправки, а у відповідь видає ідентифікатор завдання, за яким можна дізнатися статус і результат його виконання.

URI: /api/xml.php

Усі запити до API надсилаються у форматі XML за допомогою методу POST.

Параметри запиту

packagetagобов'язковий Тег для передачі облікових даних, необхідних для авторизації keyattribute | varcharобов'язковий Ваш API-ключ, який можна отримати в особистому кабінеті message-asynctagобов'язковий Тег, який визначає тип запиту msgtag Тег повідомлення. Текст повідомлення передається як параметр idattribute | integer Числовий ідентифікатор повідомлення користувача. При використанні користувач повинен переконатися, що цей ідентифікатор є унікальним в межах його акаунта recipientattribute | varchar(21)обов'язковий Номер телефону одержувача повідомлення senderattribute | varchar(11)обов'язковий Підпис у повідомленні typeattribute | integerобов'язковий Тип повідомлення: 0 - звичайне повідомлення 1 - flash повідомлення 2 - wap-push повідомлення 3 - голосове повідомлення (тільки на домашні телефони в Україні)

Приклад запиту

<?xml version="1.0" encoding="utf-8" ?>
<package key="bb56a4369eb19***cfec6d1776bd25">
    <message-async>
        <msg id="1234" recipient="+380971234567" sender="SMSTest" type="0">Текст повідомлення для відправки через SMS</msg>
        <msg id="4321" recipient="+380501234567" sender="SMSTest" type="0">Текст повідомлення для відправки через SMS</msg>
    </message-async>
</package>

Параметри відповіді

packagetag Тег для передачі облікових даних, необхідних для авторизації message-asynctag Тег, який визначає тип запиту jobtag | varchar(64) Тег, що містить ідентифікатор завдання

Приклади відповіді

Успішний

HTTP Status Code: 200
Content Type: JSON application/json

<?xml version="1.0" encoding="utf-8" ?>
<package>
    <message-async>
        <job>8714ea91e9bb454d25ef42ba6f18ea4e</job>
    </message-async>
</package>