Логотип «2Captcha»Перейти на главную страницу
Туториалы по обходу капчи

Эта статья была полезной?

Как решить капчу Temu через API: руководство по работе с координатами

Катя Пушкаренва

Технический специалист

Введение

Это руководство предназначено для разработчиков, которые автоматизируют взаимодействие с сайтом Temu.com и сталкиваются с капчами типа Temu Line или Temu Icon. В материале мы разберём, как работает метод решения через передачу координат, какие изображения необходимо подготовить и как интерпретировать ответ API.

Важное примечание: На данный момент сервис 2Captcha поддерживает решение двух типов капч с Temu, Temu Line и Temu Icon, исключительно через возврат координат. Токен-базированный метод, который будет возвращать готовый параметр для отправки на сервер Temu, находится в активной разработке. Информация о его запуске появится в документации и блоге 2Captcha.

Общие сведения

Поддерживаемые типы капч

Temu использует несколько видов интерактивных проверок. Через API 2Captcha доступны для решения два типа:

Тип капчи Описание задачи Что возвращается в ответе
Temu Line Нужно сопоставить линии на изображении, переместив фрагменты в нужные позиции Массив координат для размещения каждого фрагмента
Temu Icon Нужно кликнуть на объекты в правильном порядке Массив координат верхних левых углов найденных иконок

Принцип работы метода TemuImageTask

Метод работает по следующей схеме:

  1. Вы подготавливаете изображения, основное фоновое изображение капчи и фрагменты, которые нужно переместить или найти
  2. Конвертируете все изображения в формат base64
  3. Отправляете задачу типа TemuImageTask в API, передавая изображения в теле запроса
  4. Сервис обрабатывает задачу и возвращает массив координат
  5. Вы используете полученные координаты для эмуляции действий в браузере, кликов или перетаскивания

Требования к изображениям

Для корректной обработки задачи важно соблюдать рекомендации по размерам и формату изображений:

Для Temu Icon:

  • Основное изображение, оригинальный размер, рекомендуется около 745×749 пикселей
  • Фрагменты (иконки), примерно 167×167 пикселей каждый
  • Количество фрагментов, обычно три
  • Формат передачи, base64

Для Temu Line:

  • Основное изображение, полный скриншот области с капчей
  • Фрагменты, изображения элементов, подлежащих перемещению
  • Формат передачи, base64

Все изображения должны быть чёткими, без артефактов сжатия, которые могут помешать распознаванию.

Подготовка окружения

Перед началом работы убедитесь, что у вас есть:

  • API-ключ из личного кабинета 2Captcha
  • Инструмент для отправки HTTP-запросов, curl, Postman или библиотека для вашего языка программирования
  • Возможность конвертации изображений в base64, встроенные средства языка или онлайн-конвертеры
  • Доступ к целевой странице Temu для захвата актуальных изображений капчи

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

Анализ страницы

Для формирования задачи необходимо получить изображения непосредственно со страницы с капчей. Это можно сделать следующими способами:

  • Через инструменты разработчика браузера, найти нужные элементы на вкладке Elements, сделать скриншот области или сохранить изображение по ссылке
  • С помощью инструментов автоматизации, использовать возможности браузера для захвата элементов и конвертации их в base64

Важные моменты при анализе:

  1. Убедитесь, что капча полностью загрузилась перед захватом изображений
  2. Сохраняйте оригинальное качество изображений, избегайте повторного сжатия
  3. Фиксируйте порядок фрагментов в массиве parts, он влияет на порядок координат в ответе
  4. Проверьте, не изменилась ли структура капчи после обновления сайта

Реализация

Структура запроса на создание задачи

Задача отправляется POST-запросом на эндпоинт https://api.2captcha.com/createTask

Пример запроса TemuImageTask:

json Copy 
{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "TemuImageTask",
        "image": "/9j/4AAQSkZJRg......",
        "parts": [
            "part1_b64",
            "part2_b64",
            "part3_b64"
        ]
    }
}

Параметры задачи

Параметр Тип Обязателен Описание
clientKey Строка Да Ваш API-ключ из личного кабинета 2Captcha
task.type Строка Да Фиксированное значение TemuImageTask
task.image Строка Да Основное изображение капчи в base64
task.parts Массив Да Массив изображений фрагментов в base64

Запрос результата задачи

После создания задачи используйте taskId для получения результата. Запрос отправляется на https://api.2captcha.com/getTaskResult

json Copy 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": 80306543329
}

Пример успешного ответа

json Copy 
{
    "cost": "0.0012",
    "createTime": 1754563182,
    "endTime": 1754563190,
    "errorId": 0,
    "ip": "46.53.232.76",
    "solution": {
        "coordinates": [
            {"x": 155, "y": 358},
            {"x": 152, "y": 153},
            {"x": 251, "y": 333}
        ]
    },
    "solveCount": 1,
    "status": "ready"
}

Пояснения к параметрам

Интерпретация координат

Координаты в ответе указывают на верхний левый угол распознанного фрагмента относительно основного изображения.

Для Temu Icon:

  • Если требуется эмулировать клик по центру иконки, добавьте к полученным координатам половину ширины и высоты фрагмента
  • Пример, для фрагмента 167×167 px центр будет находиться по координатам x + 83, y + 83

Для Temu Line:

  • Координаты указывают целевую позицию для размещения каждого перемещаемого элемента
  • При эмуляции drag-and-drop используйте эти координаты как точку завершения движения

Порядок координат

Массив coordinates возвращается в том же порядке, в котором фрагменты были переданы в массиве parts. Это важно учитывать при последовательных действиях, например, при кликах по иконкам в заданном порядке.

Типичные ошибки

Ошибка Причина Решение
Неправильный формат base64 Добавлен префикс data:image/png;base64, Отправляйте только чистую base64-строку без префиксов
Ошибка авторизации Неверный clientKey Проверьте API-ключ в личном кабинете 2Captcha
Изображение слишком большое Превышен лимит размера файла Сожмите изображение до рекомендованных параметров
Неправильный порядок фрагментов Фрагменты переданы в неверном порядке Сохраняйте порядок, соответствующий логике капчи
Координаты не работают Не учтено смещение к центру элемента Добавьте половину размера фрагмента к координатам для кликов
Долгое ожидание Высокая нагрузка на сервис Увеличьте таймаут, проверьте статус аккаунта

Обратная связь по результатам решения

После получения ответа от 2Captcha и проверки его на целевом сайте рекомендуется отправить обратную связь. Это помогает улучшать качество распознавания и в некоторых случаях возвращать средства за ошибочные решения.

Если сайт отклонил решение (неправильный ответ)

Отправьте POST-запрос на эндпоинт reportIncorrect:

Эндпоинт: https://api.2captcha.com/reportIncorrect

Метод: POST

Content-Type: application/json

Пример запроса:

json Copy 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": 80306543329
}

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

json Copy 
{
    "errorId": 0,
    "status": "success"
}

Важно: не используйте этот метод, если ваш процент успеха близок к 0%. Это может указывать на ошибку в вашем коде, а не в решениях капчи.

Если сайт принял решение (правильный ответ)

Отправьте POST-запрос на эндпоинт reportCorrect:

Эндпоинт: https://api.2captcha.com/reportCorrect

Метод: POST

Content-Type: application/json

Пример запроса:

json Copy 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": 80306543329
}

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

json Copy 
{
    "errorId": 0,
    "status": "success"
}

Политика возвратов

  • Каждый случай рассматривается индивидуально
  • Для стандартных капч проверяется корректность ответа
  • Для капч с токеном анализируется статистика исполнителя
  • Возврат средств не гарантируется по каждой жалобе
  • Итоговая сумма возвратов может отличаться от количества обращений

Отправляйте отчёты честно и только после реальной проверки на целевом сайте.

Дополнительные ресурсы

Контрольный список

  • Получен и проверен API-ключ из личного кабинета 2Captcha
  • Убедились, что тип капчи относится к поддерживаемым (Temu Line или Temu Icon)
  • Подготовили основное изображение в рекомендуемом размере
  • Извлекли и подготовили фрагменты (обычно 3 шт.) в нужном формате
  • Конвертировали все изображения в base64 без лишних префиксов
  • Указали тип задачи как TemuImageTask
  • Передали изображения в правильном порядке в массиве parts
  • Учли, что координаты указывают на верхний левый угол фрагмента
  • Добавили корректировку к центру элемента при эмуляции кликов
  • Реализовали отправку отчётов reportIncorrect / reportCorrect

Заключение

Решение капч Temu через API 2Captcha на текущем этапе работает через возврат координат, которые необходимо применить на странице с помощью эмуляции действий. Метод TemuImageTask требует подготовки изображений в формате base64 и соблюдения рекомендаций по размерам.

При возникновении вопросов или трудностей с интеграцией рекомендуем обратиться в службу поддержки 2Captcha. Специалисты помогут разобраться с техническими деталями и подобрать оптимальный подход для вашей задачи.