fastsms.pro HTTP API - Получение статуса рассылки

Получение статуса рассылки:

Скрипт: http://api.fastsms.pro/parcel_status.php

Метод: POST, GET

Обязательные переменные: username, password, reference

В ответ скрипт выдаст ассоциативный массив, закодированный в JSON в виде

Array (
    'sender' => FastSms,
    'text' => ‘ПРИВЕТ’,
    'status' => 1,
    'price' => 0.14, //цена всей рассылки (может меняться со временем)
    'currency' => 1,
    'nrs' => 99, //количество номеров в рассылке
    'oks' => 77, //количество доставленных сообщений (меняется)
    'valid' => 10080,
    'plan' => 1376704800,
    'plantime' => 0,
    'typ_sms' => 0, //0 – SMS, 1 - FLASH
    'typ_txt' => 4, //1 – текст латиница, 4 - кириллица
    'name' => Название рассылки
)

Расшифровка значения переменной status:

-1 – ожидает подтверждения для отправки
0 – идет отправка
1 - отправлена
2 – отправлена с ошибками
3 - приостановлена
512 - скип
1024 - запланирована
2048 – регулярная рассылка (запланирована)

Расшифровка значений пары переменных plan и plantime:

1. plan < 8192 – регулярная рассылка.
При этом значение переменной plantime отражает время в секундах от начала суток, когда будет запущена рассылка.
Если plan < 32 – рассылка по числам месяца, значение отражает число
Если plan = 32 – рассылка производится каждый день
В остальных случаях значение битов двоичного значения числа plan отражает день недели на который запланирована рассылка. Например, значения числа plan = 320, в двоичном виде это 101000000. Последние 6 битов не учитываются (числа 0-32 уже используются), далее справа налево ПН-ВС, значит отправка запланирована на понедельник и среду.

2. plan > 8192 – отправка на определенную дату/время. Значение переменной plan – метка времени отправки (по функции time() http://www.php.su/time)

3. plan = 0 – разовая рассылка


Следующие действия возможны только для запланированных рассылок:

Приостановка рассылки: дополнительно к обязательным переменным передается переменная action = stop. При успешном выполнении операции стоимость рассылки возвращается на баланс пользователя, в параметрах рассылки передается переменная result = 'Рассылка успешно приостановлена.'.

Удаление рассылки: дополнительно к обязательным переменным передается переменная action = del. При успешном выполнении операции стоимость рассылки возвращается на баланс пользователя, в параметрах рассылки передается переменная result = 'Рассылка успешно удалена.'.

Возобновление приостановленной рассылки: дополнительно к обязательным переменным передается переменная action = start. При успешном выполнении операции стоимость рассылки списывается с баланса пользователя, в параметрах рассылки передается переменная result = 'Рассылка успешно возобновлена.'. Возможные затруднения: баланс пользователя не позволяет возобновить рассылку. В этом случае в параметрах рассылки передается переменная result = 'Не достаточно средств для возобновления рассылки.'.