меню

🪢API

Этикетка:API ,Local ,ключ ,headless

Локальный API позволяет пользователям читать и записывать информацию о конфигурации, запускать и закрывать браузер, искать учетную запись и т. д. Чтобы узнать подробности, нажмите здесь.


Как использовать AdsPower Local API

Супер администраторы имеют доступ к API по умолчанию. Если вы являетесь членом команды, убедитесь, что ваш менеджер или администратор назначил вам это разрешение.

文章图片


Перейдите в Автоматизация -> API, чтобы проверить статус подключения к API.

文章图片


Список AdsPower Local API

文章图片

Как использовать API-ключ и безголовый API

AdsPower позволяет запускать безголовый режим с API-ключом.

Перед запуском убедитесь, что версия AdsPower v3.3.2 или выше, версия ядра 2.4.2.8 или более поздняя, и у вас есть доступ к локальному API.
  • Безголовый режим: параметр для запуска автономного режима
  • API-ключ: уникальный идентификатор, используемый для аутентификации и авторизации пользователя, разработчика или вызывающей программы в API. Это позволяет управлять Local API на нескольких устройствах с одной учетной записью одновременно. У каждого члена команды есть уникальный ключ API.


Получение ключ API

Нажмите Создать или Сбросить, чтобы получить ключ API.

文章图片

文章图片

Проверка API

После включения этой опции все участники команды при использовании Local API должны будут предоставлять API Key для аутентификации.

Необходимо обновиться до патч-версии 2.8.0.3.

API Key, который вы передаёте, должен полностью совпадать с ключом от аккаунта, под которым вы вошли в клиент. Если ключ другой — получите следующую ошибку:

Как настроить передачу API Key при выполнении запроса?

1. При единичном запросе укажите API Key в Authorization.

2. При каждом запросе используется заранее заданный API Key.

1) Сначала в New Collection-Auth настройте тип аутентификации и токен (API key).

2) Справа в New Collection нажмите «Add request», итак каждый API-запрос будет использовать уже настроенный API key.

Подробнее см.  https://documenter.getpostman.com/view/45822952/2sB34hEzQH#intro

Запуск в безголовом режиме

1. Убедитесь, что вы открыли CMD или терминал в корневом каталоге AdsPower.

Корневым каталогом в Windows обычно является «C:\Program Files (x86)\AdsPower».


2. Команда запуска

Флагнеобходимо или нетописание
--headlessдаЗапуск браузера в безголовом режиме
--api-keyдаИдентификатор для использования локального API в режиме безголовом
--api-portнетУказанный порт для локальной API


В Windows:

"AdsPower Global.exe" --headless=true --api-key=XXXX --api-port=50325

В macOS:

"/Applications/AdsPower Global.app/Contents/MacOS/AdsPower Global" --args --headless=true --api-key=XXXX --api-port=50325

В Linux:

adspower_global --headless=true --api-key=XXX --api-port=50325


3. Теперь вы можете увидеть обратный адрес в интерфейсе командной строки.

文章图片


FAQ

❓Можно ли одновременно запустить на устройстве режим графического интерфейса и безголовый режим?

Нет.


Если ключ API сброшен, будет ли работать исходный API?

Нет. При сбросе ключа API , Предыдущий ключ API становится недействительным. Вам потребуется повторно подключиться к новому ключу API, чтобы убедиться, что все работает должным образом.


Если ключ API сброшен, возможно ли обновить его во время работы службы?

Нет. Сначала следует остановить службу и использовать новый ключ API, чтобы запустить ее снова.


Как остановить службу?

Нажав Ctrl+C (под CMD) или выйдя из окна командной строки Windows.


В чем разница между безголовым режимом и графическим интерфейсом?

  1. В графическом режиме вы можете в один аккаунт только на одном устройстве.
  2. С помощью API-ключа вы можете входить в учетные записи на нескольких устройствах одновременно. Это позволяет выполнять автоматизацию на нескольких устройствах для одной учетной записи AdsPower.


Как устранять ошибки?

Вот наши демо-версии для API: https://github.com/AdsPower/localAPI

Предыдущий
🤖RPA
Следующий
🧑‍🤝‍🧑Команда
Последнее изменение: 2025-09-22Powered by