Обновить статистику по базе данных

Описание

Обновить статистику подписок профилей в базе.

Возвращает ответ с ID задания, не дожидаясь выполнения.

URL-адрес

Метод: POST

https://example.com/api/v1.1/databases/refresh_counters

Параметры запроса

Параметр	Тип	Пример	Обязательный	Описание
token	string	"abcdefghijklmnqrstuvwxyz"	Да	API-токен
id	int	1	Да	Идентификатор базы данных
resource_id	int	1	Да	Идентификатор ресурса
format	JSON object	"json"	Нет	Формат возвращаемых данных по умолчанию – "json"
feedback	JSON object	"feedback": { "type": "JSON", "url": "http://example.com/receiver" }	Нет	Параметр, опеределяющий способ отправки данных об обновлении статистики. Параметр "type" – формат или метод, используемый для отправки данных. "url" – URL-адрес, на который будут отправлены данные статистики.

Пример запроса

JSON

{
    "token": "abcdefghijklmnqrstuvwxyz",
    "id": 5,
    "resource_id": 24,
    "format": "json",
    "feedback": {
        "type": "JSON",
        "url": "http://example.com/receiver"
    }
}

XML

<xml>
     <token>abcdefghijklmnqrstuvwxyz</token>
     <id>5</id>
     <resource_id>24</resource_id>
     <format>json</format>
     <feedback>
         <type>JSON</type>
         <url>http://example.com/receiver</url>
     </feedback>
 </xml>

Пример ответа

JSON

{
    "data": {
        "task_id": "6908adeb-346e-4f5e-9f68-df062bf795cf"
    },
    "error": 0,
    "error_text": "Successful operation"
}

XML

<xml>
     <data>
         <task_id>6908adeb-346e-4f5e-9f68-df062bf795cf</task_id>
     </data>
     <error>0</error>
     <error_text>Successful operation</error_text>
 </xml>

Возвращаемые параметры

Параметр	Тип	Описание
data	JSON objects	Содержит идентификатор задания – task_id
error	int	Код ошибки
error_text	string	Текст ошибки

Проверка статуса задания

URL-адрес

Метод: POST

https://example.com/api/v1.1/tasks/status

Параметры запроса

Параметр	Тип	Пример	Обязательный	Описание
token	string	"abcdefghijklmnqrstuvwxyz"	Да	API-токен
task_id	string	"518f4997-ec43-4df5-bfd0-093aaacf679f"	Да	Идентификатор задания

Пример запроса

JSON

{
    "task_id": "930bfdb0-a5a8-4207-a77d-6b989bdea326",
    "token": "abcdefghijklmnqrstuvwxyz"
}

XML

<xml>
     <task_id>930bfdb0-a5a8-4207-a77d-6b989bdea326</task_id>
     <token>abcdefghijklmnqrstuvwxyz</token>
</xml>

Пример ответа

JSON

{
    "data": {
        "status": "completed",
        "progress": 100,
        "result": [
            {
                "channels": [
                    {
                        "channel": "email",
                        "status": {
                            "all": 1336,
                            "complained": 0,
                            "hardbounced": 411,
                            "invalid": 0,
                            "subscribed": 925,
                            "subscribed_sendable": 925,
                            "suspended": 0,
                            "unconfirmed": 0,
                            "unconfirmed_sendable": 0,
                            "unsubscribed": 0
                        }
                    },
                    {
                        "channel": "push",
                        "status": {
                            "all": 1336,
                            "complained": 0,
                            "hardbounced": 0,
                            "invalid": 0,
                            "subscribed": 0,
                            "subscribed_sendable": 0,
                            "suspended": 0,
                            "unconfirmed": 0,
                            "unconfirmed_sendable": 0,
                            "unsubscribed": 0
                        }
                    },
                    {
                        "channel": "sms",
                        "status": {
                            "all": 1336,
                            "complained": 0,
                            "hardbounced": 0,
                            "invalid": 0,
                            "subscribed": 0,
                            "subscribed_sendable": 0,
                            "suspended": 0,
                            "unconfirmed": 0,
                            "unconfirmed_sendable": 0,
                            "unsubscribed": 0
                        }
                    }
                ],
                "in_progress": false,
                "last_count_time": "counted at 2024-04-17T21:36:01Z in 82.746959ms",
                "refresh_task_id": "",
                "resource_id": 24,
                "total_count": 1336,
                "updated": "2024-04-17T21:36:01.449Z"
            }
        ]
    },
    "error": 0,
    "error_text": "Successful operation"
}

XML

<xml>
     <data>
         <status>completed</status>
         <progress>100</progress>
         <result>
             <channels>
                 <channel>email</channel>
                 <status>
                     <all>1336</all>
                     <complained>0</complained>
                     <hardbounced>411</hardbounced>
                     <invalid>0</invalid>
                     <subscribed>925</subscribed>
                     <subscribed_sendable>925</subscribed_sendable>
                     <suspended>0</suspended>
                     <unconfirmed>0</unconfirmed>
                     <unconfirmed_sendable>0</unconfirmed_sendable>
                     <unsubscribed>0</unsubscribed>
                 </status>
             </channels>
             <channels>
                 <channel>push</channel>
                 <status>
                     <all>1336</all>
                     <complained>0</complained>
                     <hardbounced>0</hardbounced>
                     <invalid>0</invalid>
                     <subscribed>0</subscribed>
                     <subscribed_sendable>0</subscribed_sendable>
                     <suspended>0</suspended>
                     <unconfirmed>0</unconfirmed>
                     <unconfirmed_sendable>0</unconfirmed_sendable>
                     <unsubscribed>0</unsubscribed>
                 </status>
             </channels>
             <channels>
                 <channel>sms</channel>
                 <status>
                     <all>1336</all>
                     <complained>0</complained>
                     <hardbounced>0</hardbounced>
                     <invalid>0</invalid>
                     <subscribed>0</subscribed>
                     <subscribed_sendable>0</subscribed_sendable>
                     <suspended>0</suspended>
                     <unconfirmed>0</unconfirmed>
                     <unconfirmed_sendable>0</unconfirmed_sendable>
                     <unsubscribed>0</unsubscribed>
                 </status>
             </channels>
             <in_progress>false</in_progress>
             <last_count_time>counted at 2024-04-17T21:36:01Z in 82.746959ms</last_count_time>
             <refresh_task_id></refresh_task_id>
             <resource_id>24</resource_id>
             <total_count>1336</total_count>
             <updated>2024-04-17T21:36:01.449Z</updated>
         </result>
     </data>
     <error>0</error>
     <error_text>Successful operation</error_text>
</xml>