Реєстрація

Модуль Taskqueue

Отримання інформації про задачі в черзі асинхронного виконання завдань

Методи API

Отримання прогресу виконання фонової задачі
https://api.mobizon.ua/service/Taskqueue/GetStatus

Отримання прогресу виконання фонової задачі

https://api.mobizon.ua/service/Taskqueue/GetStatus

Цей метод дозволяє отримати прогрес виконання фонової задачі за її ID. Наш сервіс використовує фонові задачі для того, щоб вашим процесам не доводилося чекати завершення довгого запиту в таких випадках як:

  • Завантаження одержувачів у SMS-кампанію;
  • Імпорт контактів у контактну книгу;
  • Створення звітів про кампанії та повідомлення.
Цей запит слід надсилати не частіше 1 разу на секунду.

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

ПараметрТипОпис
idintegerІдентифікатор фонової задачі.

Відповідь сервера

Масив даних:

ПолеТипОпис
progressintegerПрогрес виконання задачі за шкалою від 0 до 100%.
statusintegerКод статусу задачі:
0 – очікує початку виконання;
1 – у процесі;
2 – завершена;
3 – відхилена.

Коди відповідей API

КодОпис
0Прогрес виконання фонової задачі успішно отримано.
2Якщо задачу з вказаним ідентифікатором не знайдено.

Примеры

curl -X POST \
  'https://api.mobizon.ua/service/taskqueue/getStatus?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'id=123'
var data = "id=123";

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});

xhr.open("POST", "https://api.mobizon.ua/service/taskqueue/getStatus?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");

xhr.send(data);
<?php
use Mobizon\MobizonApi;

$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.ua');

// Виклик АПІ методу
if ($api->call(
    'taskqueue',
    'getStatus',
    array(
        //ідентифікатор фонової задачі
        'id' => '123'
    )
)
) {
    // Отримання результату виконання методу
    $result = $api->getData();
} else {
    // Під час виконання сталася помилка, вивід коду помилки і тексту повідомлення
    echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}