Категоризация домена - получение списка задач
Метод DomainClassification.getTaskList позволяет получить список задач с их статусом.
Пример использования: Эффективное управление результатами категоризации нескольких доменов
1. Получение списка выполненных задач: используйте DomainClassification.getTaskList для доступа к полному списку всех выполненных задач категоризации доменов.
2. Просмотр сводок задач: получение сводной информации по каждой задаче, включая идентификаторы задач, даты создания и статусы, что позволяет быстро оценить, какие задачи готовы к более глубокому анализу.
3. Доступ к подробным результатам для выбранных задач: после того, как вы определили соответствующие задачи, используйте идентификаторы задач, чтобы перейти к конкретным данным категоризации для получения целевых сведений.
Общие параметры запроса и инструкция по использованию Serpstat API
Параметры запроса | |||||
Параметр | Описание | Тип данных | Обязательный | Значение по умолчанию | Варианты значений |
method | Название API метода | string | да | DomainClassification.getTaskList | |
id | Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения. | int/string | да | Любое текстовое или числовое значение. | |
params | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] | array | да |
| |
page | Номер страницы в ответе | int | да | 1 | "page": "2" |
size | Количество результатов на страницу в ответе | int | да | 20 | "size": "20" допустимые значения: "20", "50", "100", "200", "500" |
Параметры ответа | |
Параметр | Описание |
id | Идентификатор запроса: соответствует id в запросе |
result | Содержит в себе ответ |
data | Массив с данными |
task_id | Идентификатор задачи для получения результата |
status | Статус задачи |
created_at | Дата и время, когда была поставлена задача |
summary_info | Объект с данными |
page | Номер страницы |
page_total | Общее количество страниц с результатами |
count | Количество результатов на текущей странице |
total | Общее количество результатов |
Статусы задачи | |
Код | Описание |
1 | В обработке |
2 | Выполнен |
3 | Ошибка |
По этому методу лимиты не списываются.
{
"method": "DomainClassification.getTaskList",
"id": 1,
"params": {
"page": 1,
"size": 20
}
}
{
"id": "1",
"result": {
"data": [
{
"task_id": "565892-fb87d8fa-f4c2-4b87-aa20-8ef72639625f",
"status": "2",
"created_at": "2024-07-31 13:36:20"
},
{
"task_id": "565892-831b7e55-62ab-4165-9ea6-4260b6b73448",
"status": "1",
"created_at": "2024-07-31 15:25:03"
}
],
"summary_info": {
"page": 1,
"page_total": 1,
"count": 20,
"total": 2
}
}
}