🏠 Главная API TOOLS

API ARSENKIN TOOLS

Документация по API сервиса «ARSENKIN TOOLS» поможет разработчикам и пользователям получать данные от инструментов для собственных разработок в удобном JSON формате.

API поддерживается только для пользователей на платных тарифах STANDARD и КОРПОРАТИВНЫЙ.

Как получить токен API?

Чтобы получить токен API выполните следующие действия:

Зарегистрируйтесь в сервисе ARSENKIN TOOLS.
Перейдите в раздел Данные профиля.
Сгенерировать API токен.

Обратите внимание. Создание токена API возможно только после покупки тарифа STANDARD или КОРПОРАТИВНЫЙ.

Введение в API

URL запроса для обращения к серверу API

Все запросы к API должны направляться на https://arsenkin.ru/tools/api/ с помощью метода POST.

Постановка задачи:

https://arsenkin.ru/tools/api/task/set

Проверка статуса задачи:

https://arsenkin.ru/tools/api/task/check

Получение результата

https://arsenkin.ru/tools/api/task/result

Если вы получаете 500 код ответа, значит задача ещё не выполнена. Мы настоятельно рекомендуем проверять статус выполнения задачи;

Ограничение на использование API

1) Для одного пользователя - выполняется не более 5-и задач одновременно, не более. В случае попытки постановки задач сверх лимита выдается ошибка либо уходит в очередь. Размер очереди - 50 задач, после уже задачи не будут ставиться.

2) За одну минуту можно делать не более 30 запросов ко всем статусам (включая постановку задач, проверку статуса и передачу результатов). При превышении этого лимита, вы получите код ошибки 429. Пожалуйста, повторите попытку.

{"status":"Error","code":"429","error":"Too Many Requests"}

Формат передачи данных

Авторизация: по токену пользователя, передается в качестве GET параметра с именем token.

Название инструмента: передается в качестве GET параметра с именем tools_name.

Постановка задачи: осуществляется посредством POST запроса на url https://arsenkin.ru/tools/api/task/set.

ВАЖНО. Все параметры передаваемые в инструментах должны идти через POST запрос, кроме token и tools_name. Пример PHP кода по ссылке.

Формат ответа

Поддерживается только один формат ответа: JSON.

Получение системной информации

Получение информации о имеющихся и затраченных лимитах аккаунта.

https://arsenkin.ru/tools/api/stat?token=ВАШ_ТОКЕН

limits_total - общее количество лимитов на аккаунте

Возвращает JSON с результатами, пример ответа:

{
  "limits_total": 30000
}

Получение списка задач, которые ВЫПОЛНЯЮТСЯ на текущий момент (выполненные задачи списком нельзя получить).

https://arsenkin.ru/tools/api/tasks?token=ВАШ_ТОКЕН

Возвращает JSON с результатами, пример ответа:

[
  {
    "user_id": 84216,
    "task_id": 23319462,
    "tools": "Выгрузка ТОП",
    "datetime": "2024-01-29 11:15:31",
    "progress": "49",
    "status": "process"
  },
  {
    "user_id": 84216,
    "task_id": 23319469,
    "tools": "Проверка коммерциализации",
    "datetime": "2024-01-29 11:16:13",
    "progress": "28",
    "status": "process"
  }
]

Удалить задачу в статусе "В работе"

https://arsenkin.ru/tools/api/action/delete?token=ВАШ_ТОКЕН&task_id=ID_ЗАДАЧИ

Данный метод позволяет удалить задачу, которая сейчас находится в статусе "В работе". Метод дублирует функционал со страницы https://arsenkin.ru/tools/queue/.

Перезапустить задачу (использовать осторожно)

https://arsenkin.ru/tools/api/action/restart?token=ВАШ_ТОКЕН&task_id=ID_ЗАДАЧИ

Данный метод позволяет перезапустить задачу, которая сейчас находится в статусе "В работе". Метод дублирует функционал со страницы https://arsenkin.ru/tools/queue/. Функционал активируется через 12 часов после постановки задачи.

Статусы ошибок

'error' => 'Access denied! Invalid token', 'error_code' => 1
'error' => 'Не указан task_id', 'error_code' => 3
'error' => 'Undefinded action', 'error_code' => 2

'error_code' => 3, 'message' => 'Активные задачи можно перезапустить только через 1 час'
'error_code' => 0, 'message' => 'Задача успешно перезапущена...'
'status' => 1, 'message' => 'Ошибка перезапуска'
'status' => 0, 'message' => 'Задача успешно удалена...'
'status' => 1, 'message' => 'Ошибка удаления'
'status' => 2, 'message' => 'Задача не найдена в списке активных или это не ваша задача'