Создание быстрого профиля с помощью Postman

Быстрые профили в Postman идеально подходят для одноразовых задач, не требующих постоянного хранения данных. При закрытии быстрого профиля он автоматически удаляется вместе со всеми связанными данными, обеспечивая чистый лист для временных операций. Это руководство поможет вам запустить быстрые профили с использованием конечной точки POST Start Quick Profile v3 в Postman, охватывая настройку прокси, варианты автоматизации и headless-режим.

Что такое быстрые профили?

Быстрые профили — это временные профили браузера, предназначенные для одноразовых задач. Они используют конечную точку POST Start Quick Profile v3 для запуска профилей с пользовательскими настройками, такими как прокси, фреймворки автоматизации (Selenium, Puppeteer, Playwright) и headless-режим, без сохранения данных после завершения сессии.

Предварительные требования

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

1. Настройте аутентификацию Postman: Выполните три шага, описанные в Как настроить Postman для API Indigo X, включая раздел «Настройка токена носителя для запросов», чтобы обеспечить корректный вход.
2. Доступ к рабочему пространству Postman: Перейдите в папку Launcher в вашем рабочем пространстве Postman.
3. Выберите конечную точку: Выберите конечную точку POST Start Quick Profile v3 из папки Launcher.

Совет по токену носителя

Убедитесь, что ваш токен носителя действителен и включен во вкладку Authorization вашего запроса Postman, чтобы избежать ошибок аутентификации.

Шаг 1: Настройка конечной точки POST Start Quick Profile

Для создания быстрого профиля вы будете использовать конечную точку POST Start Quick Profile v3 в разделе Launcher Postman. Следуйте этим шагам для настройки:

1. Перейдите к конечной точке:

   • Откройте ваше рабочее пространство Postman.
   • Перейдите в раздел Launcher.
   • Выберите конечную точку POST Start Quick Profile v3.

2. Добавьте прокси:

   • Перейдите на вкладку Body в редакторе запросов.
   • Прокрутите до раздела flags и установите proxy_masking в значение custom.
   • Добавьте данные вашего прокси в параметр proxy (см. пример ниже для структуры).

3. Настройте автоматизацию и headless-режим:

   • Укажите параметр automation для включения фреймворков автоматизации:
     • Варианты: selenium, puppeteer или playwright.
     • Включение этого параметра возвращает порт автоматизации в ответе.
   • Установите параметр is_headless в true или false для включения или отключения headless-режима.
   • Если автоматизация или headless-режим не нужны, исключите эти параметры, опустив их или установив в null.

Необязательные параметры

Если вы не используете автоматизацию или headless-режим, упростите ваш запрос, исключив эти поля. Это снижает сложность и делает профиль легковесным.

Шаг 2: Подготовка тела запроса

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

Тело запроса JSON

{
  "browser_type": "mimic",
  "os_type": "windows",
  "core_version": 124,
  "parameters": {
    "fingerprint": {},
    "proxy": {
      "host": "<string>",     // ХОСТ или IP
      "type": "url",         // HTTP или SOCKS5
      "port": "<integer>",   // ПОРТ
      "username": "<string>",
      "password": "<string>"
    },
    "flags": {
      "audio_masking": "natural",
      "fonts_masking": "natural",
      "geolocation_masking": "custom",
      "geolocation_popup": "prompt",
      "graphics_masking": "natural",
      "graphics_noise": "natural",
      "localization_masking": "mask",
      "media_devices_masking": "mask",
      "navigator_masking": "mask",
      "ports_masking": "mask",
      "proxy_masking": "custom",
      "screen_masking": "natural",
      "timezone_masking": "mask",
      "webrtc_masking": "natural"
    }
  },
  "automation": "selenium",
  "is_headless": false
}

Описание ключевых параметров

• browser_type: Указывает эмуляцию браузера (например, mimic).
• os_type: Определяет операционную систему (например, windows).
• core_version: Устанавливает версию ядра браузера (например, 124).
• proxy: Настраивает параметры прокси, включая хост, тип, порт и учетные данные.
• flags: Управляет поведением маскировки для аудио, шрифтов, геолокации и т.д. Устанавливается в natural, mask или custom по необходимости.
• automation: Указывает фреймворк автоматизации (selenium, puppeteer или playwright).
• is_headless: Включает (true) или отключает (false) headless-режим.

Настройка прокси

Убедитесь, что данные прокси (хост, порт, имя пользователя, пароль) верны. Неправильные настройки могут привести к сбоям соединения или ошибкам запуска профиля.

Шаг 3: Запуск скрипта

Для запуска быстрого профиля выполните запрос в Postman:

1. Проверьте подключение агента:

   • Убедитесь, что агент Postman подключен, так как он обеспечивает запуск профиля.
   • Проверьте статус агента в правом нижнем углу Postman.

2. Отправьте запрос:

   • Нажмите кнопку Send в Postman для выполнения запроса.
   • Код статуса 200 OK указывает на успех.
   • Ответ включает ID профиля и, если автоматизация включена, порт автоматизации.

Пример ответа

{
  "data": {
    "browser_type": "mimic",
    "core_version": 132,
    "id": "d04aa438-d887-11ef-8d6d-0a0027000012",
    "is_quick": true,
    "port": "55579"
  },
  "status": {
    "error_code": "",
    "http_code": 200,
    "message": "Quick profile started successfully"
  }


}