Категоризація домену - отримання списку завдань
Метод DomainClassification.getTaskList дозволяє отримати список завдань з їх статусом.
Приклад використання: Ефективне керування результатами категоризації декількох доменів
1. Отримання списку виконаних завдань: використовуйте DomainClassification.getTaskList для доступу до повного списку всіх виконаних завдань категоризації доменів.
2. Перегляд зведення задач: отримання зведеної інформації з кожного завдання, включаючи ідентифікатори завдань, дати створення та статуси, що дозволяє швидко оцінити, які завдання готові до більш глибокого аналізу.
3. Доступ до детальних результатів для вибраних завдань: після того, як ви визначили відповідні завдання, використовуйте ідентифікатори завдань, щоб перейти до конкретних даних категоризації для отримання цільових відомостей.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Параметри запиту | |||||
Параметр | Опис | Тип даних | Обов'язковий | Значення за замовчуванням | Варіанти значень |
method | Назва методу API | string | так | DomainClassification.getTaskList | |
id | Ідентифікатор запиту: відповідь буде містити | int/string | так | Будь-яке числове або текстове значення. Наприклад: 1, test | |
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
}
}
}