Clicky

REST API

Обновлено 21/3/20 от Daniel

REST API предоставляют программный доступ к чтению и записи данных связанных с браузерными профилями Multilogin. К Rest API запросам относятся: создание браузерного профиля, получения списка всех браузерных профилей, перемещение бразуерного профиля в группу и другие.

REST API эндпойнты

Существует две версии Rest API – v1 и v2. Rest API v1 используется для удаления профилей, получения списка профилей, отображения настроек профилей, а также для управления группами профилей. Однако создание и редактирование настроек профилей может быть выполнено только при использовании Rest API v2.

Rest API v1 и v2 эндпойнты доступны в нашей Swagger документации (также известен как OpenAPI спецификация):

Rest API v1 в Swagger

Rest API v2 в Swagger

Аутентификация пользователя и API токен

Аутентификация при отправке запросов происходит по токену пользователя, который отправляется вместе с запросом. Токен можно найти в app.properties файле, который в Windows обычно находится в следующей директории:

C:/Users/%username%/.mulltiloginapp.com/

Для получения токена аккаунта, вы должны быть авторизированны в приложении Multilogin.

Важно! Токен аутентификации эквивалентен вашему паролю. Храните в секрете ваш токен и не передавайте его третьим лицам.

Plan limits

REST API доступны только пользователям с Automate и Scale подписками с ограничениями по количеству запросов в секунду.

Если Rest API запрос будет отправлен с подписки без разрешения на Rest API запросы, сервер ответит следующим образом:

{"status":"ERROR","value":"unauthorized"}

Ограничения по кол-ву запросов

Ко всем стандартным подпискам применены ограничения по количеству запросов. Ограничения делятся на два типа:

  • Запросы возвращающие списки - 1 запрос в минуту
  • Запросы Create и Update - 1 запрос в минуту.
  • Все остальные запросы - 10 запросов в минуту

При достижении лимита, сервер будет отвечать на запрос со следующей ошибкой

{"status":"ERROR","value":"rate limit exceeded."}

Увеличение лимита API доступно в кастомных подписках. Для дополнительной информации, свяжитесь с нашей технической поддержкой.


Была ли полезной эта статья?