Профили с вашего сервера

Помощь · Автоматизация

Ваш собственный сервис (панель автозалива, CRM, фарм) может управлять вашим GetAntik: создать профиль с прокси и cookies, запустить его, остановить. Сервис отправляет заявку на сервер, приложение забирает её и выполняет у себя. Для создания приложение не обязано быть запущено: заявка дождётся его. Нужен API-ключ аккаунта.

Создать профиль

1. POST https://api.getantik.com/v1/remote/profiles с заголовком Authorization: Bearer antik_… и телом JSON: name, proxy, cookies, при желании platform (windows | macos | linux), group, tags, notes, start, device.
2. Ответ 202 сразу содержит profile_id — id будущего профиля, по нему потом запускают и останавливают, — а также request_id, sealed (заявка запечатана ключом аккаунта) и app_online (приложение сейчас на связи).
3. Если GetAntik запущен и вошёл в этот аккаунт, профиль появится через несколько секунд; при start: true он сразу откроется.
4. Если приложение закрыто, заявка ждёт. При следующем запуске профиль будет создан, но не открыт — иначе все накопившиеся окна открылись бы разом.

Запустить и остановить

POST /v1/remote/profiles/{profile_id}/start и POST /v1/remote/profiles/{profile_id}/stop. Работают только пока приложение на связи: иначе ответ 409 app_offline, в очередь такая заявка не ставится. Ответ 202 с request_id; результат — по статусу заявки.

Статус заявки

GET /v1/remote/requests/{request_id} → kind, status (pending | done | failed), profile_id, error с причиной. GET /v1/remote/requests?status=&profile_id= — последние заявки, DELETE /v1/remote/requests/{request_id} — отозвать ещё не взятую.

Cookies и прокси

cookies — текст в формате JSON-массива (как у Cookie-Editor) или Netscape cookies.txt, до 1 МБ; они будут поставлены при первом запуске профиля. proxy — в любой записи, которую принимает приложение: scheme://user:pass@host:port, host:port или host:port:user:pass. Неверный прокси или cookies дают статус failed с текстом ошибки.

Логин, пароль и 2FA

autofill — список записей { label, value }: подпись и значение, которые расширение подставит в любое поле по правому клику; логин и пароль аккаунта передаются двумя такими записями. totp — список ключей 2FA { label, secret, digits, step }: секрет в base32, как выдаёт сайт, digits и step по умолчанию 6 и 30. Коды показываются на стартовой странице профиля и в расширении. Всё это запечатывается вместе с cookies. С версии 0.1.51.

Безопасность

Cookies — это ваша вошедшая сессия. Если у аккаунта включено шифрование, сервер запечатывает заявку публичным ключом аккаунта в момент приёма и прочитать её может только ваше приложение; в ответе sealed: true. Без шифрования заявка хранится открытой до тех пор, пока приложение её не заберёт.

Несколько компьютеров

Если приложение открыто на нескольких устройствах, заявку возьмёт первое, которое выйдет на связь. Чтобы профиль создавался на определённом компьютере, передайте device — имя устройства, как оно показано в Настройки → Аккаунт.

Регистрация аккаунта из сервиса

Партнёрский сервис с ключом интеграции может зарегистрировать аккаунт для своего пользователя одним запросом: POST /v1/integrations/register с Authorization: Bearer int_… и телом { email, language }. Пользователю приходит письмо с логином и паролем, сервису — api_key аккаунта для запросов выше. Если почта уже зарегистрирована, ответ 409 email_taken: тогда пользователь создаёт API-ключ в Настройки → API-ключи и передаёт его сервису. Ключ интеграции выдаёт поддержка GetAntik.

Возможные ошибки