Обзор

Парсер: задачи сбора и воркеры

Парсер собирает данные, из которых потом получается база контактов кампании. Он опубликован только в версии v1 — в v2 этих операций нет.

Работа делится на три части: задачи сбора, системные аккаунты, от имени которых сбор идёт, и воркеры, которые его выполняют.

Задачи сбора#

GET/v1/parser/tasks

Список задач сбора.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

POST/v1/parser/tasks

Создать задачу сбора. Тело запроса — JSON.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

GET/v1/parser/tasks/{task_id}

Состояние задачи сбора.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
task_idstringобязательный

UUID задачи

POST/v1/parser/tasks/{task_id}/cancel

Отменить выполняющуюся задачу.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
task_idstringобязательный

UUID задачи

GET/v1/parser/tasks/{task_id}/export

Выгрузить результат задачи.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
task_idstringобязательный

UUID задачи

DELETE/v1/parser/tasks/{task_id}

Удалить задачу вместе с её результатом.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
task_idstringобязательный

UUID задачи

POST/v1/parser/entity-checks

Создать проверку сущности. Тело запроса — JSON.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Системные аккаунты#

Системные аккаунты — отдельные аккаунты, от имени которых работает парсер. Они подключаются собственной сессией авторизации, устроенной так же, как подключение обычного аккаунта: код, при необходимости облачный пароль.

GET/v1/parser/system-accounts

Список системных аккаунтов парсера.

Authorization
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

GET/v1/parser/system-accounts/{account_id}

Карточка системного аккаунта.

Authorization
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Path
account_idstringобязательный

UUID системного аккаунта

DELETE/v1/parser/system-accounts/{account_id}

Отключить системный аккаунт.

Authorization
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Path
account_idstringобязательный

UUID системного аккаунта

POST/v1/parser/system-accounts/auth-sessions

Открыть сессию авторизации системного аккаунта. Тело запроса — JSON.

Authorization
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

GET/v1/parser/system-accounts/auth-sessions/{auth_id}

Состояние сессии авторизации.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
auth_idstringобязательно

UUID сессии

POST/v1/parser/system-accounts/auth-sessions/{auth_id}/code

Передать код подтверждения. Тело запроса — JSON.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
auth_idstringобязательно

UUID сессии

POST/v1/parser/system-accounts/auth-sessions/{auth_id}/password

Передать облачный пароль при двухфакторной защите. Тело запроса — JSON.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
auth_idstringобязательно

UUID сессии

DELETE/v1/parser/system-accounts/auth-sessions/{auth_id}

Прервать незавершённую сессию.

Авторизация
Авторизациястрока

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
auth_idстрокаобязательно

UUID сессии

Воркеры#

GET/v1/parser/workers

Список воркеров парсера и их состояние.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

GET/v1/parser/workers/{node_name}

Состояние одного воркера.

Авторизация
Authorizationstring

Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.

Путь
node_namestringобязательный

Имя узла воркера

Дальше#

Updated

Парсер: задачи сбора и воркеры — NN Agent