Тестирование solvethree в Postman

1. 1.

   Импортируйте скачанный JSON

   В Postman выберите «Импорт» и укажите файл коллекции. Она содержит запросы «Создать задачу» и «Получить задачу» с наследуемой авторизацией Bearer и заполнителями переменных.

2. 2.

   Проверьте профиль сайта

   В вашем рабочем пространстве должен быть активный профиль для имени хоста целевого сайта. Настройте его в консоли перед тестированием; отправка имени хоста и действия не создаёт профиль. См. Настройка профиля сайта.

3. 3.

   Настройте приватные значения окружения

   Создайте и выберите окружение для этого теста. Конфиденциально заполните указанные ниже значения, включая учётные данные прокси. Не помещайте секреты непосредственно в коллекцию и не экспортируйте заполненные секретные значения.

4. 4.

   Настройте авторизацию Bearer

   На уровне коллекции выберите Bearer Token и укажите ссылку на приватную переменную окружения с ключом API вашего рабочего пространства. Для обоих запросов оставьте наследование авторизации. API ожидает Authorization: Bearer, за которым следует этот ключ.

Откройте «Создать задачу». Этот запрос отправляет POST на https://api.solvethree.com/v1/tasks с необработанным телом JSON, заполненным из выбранного окружения.

{
  "site": "{{SITE}}",
  "action": "{{ACTION}}",
  "proxy": "{{PROXY}}",
  "requestId": "{{REQUEST_ID}}"
}

По умолчанию этот запрос использует reCAPTCHA Enterprise v3. Не добавляйте поля type и url. Он передаёт один proxy, поэтому не добавляйте также proxyCandidates: требуется ровно одно из этих полей.

Задайте REQUEST_ID перед отправкой, затем нажмите «Отправить» один раз. Сначала проверьте HTTP-ответ. Если он неуспешный, изучите ошибку запроса, а не считайте тело успешным ответом с задачей. Исправляйте некорректные входные данные вместо того, чтобы многократно отправлять их без изменений.

При успешном ответе на создание скопируйте полученный id в приватное значение окружения TASK_ID. Не нажимайте «Создать задачу» повторно только для проверки прогресса.

Откройте «Получить задачу» и убедитесь, что TASK_ID содержит полученный ID задачи. Этот запрос использует GET /v1/tasks/:id того же API. Отправьте его вручную, проверьте HTTP-ответ, затем изучите status задачи.

Сам по себе HTTP 200 или 201 не означает, что решение готово; об этом говорит только status: ready. Этот ручной тест проверяет создание и получение задачи, а не то, принимает ли целевой сайт результат.

Если затем вы отправляете токен reCAPTCHA на предназначенный для него целевой сайт, используйте полученные идентификационные данные браузера userAgent и secChUa, а также прокси, через который удалось получить решение. Не меняйте IP-адрес и не подставляйте посторонние идентификационные данные браузера. Целевой сайт всё равно может отклонить готовый токен.

Тайм-аут подключения не доказывает, что создание завершилось ошибкой. Если у вас есть ID задачи, получите её. Если ID так и не был получен, повторно отправьте «Создать задачу» с тем же REQUEST_ID и неизменёнными входными данными задачи. Это восстанавливает существующую задачу, а не создаёт новую логическую задачу.

Не генерируйте новый REQUEST_ID только потому, что ответ был потерян. Повторное использование ID с другими входными данными задачи вызывает конфликт; используйте новый ID, когда намеренно запускаете новую задачу.