Ваше первое решение
Сгенерируйте токен, набор заголовков или cookie одним запросом и отправьте результат с теми идентификационными данными, для которых он выдан.
быстрый старт
- 01Сгенерировать токен
- 02Сгенерировать Kasada
- 03Сгенерировать TMPT
- 04Асинхронный резервный сценарий
- 05Обработка ошибок
базовый URL
https://api.solvethree.com/v1
аутентификация
Authorization: Bearer <key>
Полный справочник по интеграции в формате Markdown.
Сгенерировать токен
POST /v1/tasks · 201
curl https://api.solvethree.com/v1/tasks \
-H "Authorization: Bearer $SOLVETHREE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "login_20260910_0001"
}'{
"id": "login_20260910_0001",
"status": "ready",
"solution": {
"token": "03AFcWeA5…kQ2b",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
"secChUa": "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\""
},
"durationMs": 1742
}Запрос создания ожидает до 15 секунд и обычно возвращает готовый токен. У сайта должен быть активный профиль в этом рабочем пространстве. Если сайт назначен вашему безлимитному тарифу, задача входит в тариф; для любого другого сайта резервируется одна единица баланса оплаты по использованию.
Необязательные поля (требуется proxy или proxyCandidates)
- recaptchaType
- Используйте "v3" для обычной v3. Не указывайте значение, чтобы использовать обратно совместимый вариант по умолчанию "enterprise-v3".
- requestId
- Ваш собственный ключ идемпотентности длиной 1–64 символа. При повторной отправке возвращается та же задача.
- proxyCandidates
- До шести различных HTTP(S)-прокси. solution.egressAttempts — индекс сработавшего кандидата, начиная с единицы. Для сессий требуется один прокси.
- userAgent, secChUa
- Зафиксируйте идентификационные данные браузера, которые будете использовать с токеном.
- timezoneOffsetMinutes
- Укажите часовой пояс клиента, который отправляет токен.
- session
- Сохраняйте сессию между задачами для многошаговых сценариев.
Сгенерировать заголовки Kasada
$1.25 за 1,000 · средства за неудачные задачи возвращаются
curl https://api.solvethree.com/v1/tasks \
-H "Authorization: Bearer $SOLVETHREE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "KasadaTask",
"url": "https://www.ticketmaster.com/discovery/v2/events",
"proxy": "http://user:[email protected]:8080"
}'{
"id": "req_92ad…",
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
"secChUa": "\"Chromium\";v=\"151\", \"Google Chrome\";v=\"151\"",
"headers": {
"x-kpsdk-ct": "…",
"x-kpsdk-cd": "…",
"x-kpsdk-h": "…",
"x-kpsdk-v": "…"
},
"egressAttempts": 1
}
}Отдельный сервис Kasada сейчас поддерживает HTTPS-адреса на www.ticketmaster.com. Немедленно применяйте все возвращённые заголовки вместе с возвращёнными идентификационными данными браузера и прокси, с которым решение прошло успешно. Наборы заголовков привязаны к целевому ресурсу, идентификационным данным и точке выхода в сеть. Назначьте Kasada слоту безлимитного тарифа, чтобы включить эти задачи в свой тариф.
Сгенерировать Ticketmaster TMPT
$0.99 за 1,000 · средства за неудачные задачи возвращаются
curl 'https://api.solvethree.com/v1/tasks?waitMs=75000' \
-H "Authorization: Bearer $SOLVETHREE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "TicketmasterTmptTask",
"url": "https://www.ticketmaster.com/example/event/1A2B3C4D5E6F7A8B",
"action": "Event",
"proxy": "http://user:[email protected]:8080"
}'{
"id": "req_7f4c…",
"status": "ready",
"solution": {
"token": "tmpt-cookie-value…",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
"secChUa": "\"Chromium\";v=\"151\", \"Google Chrome\";v=\"151\"",
"egressAttempts": 1
},
"durationMs": 2310
}URL Ticketmaster обязателен; идентификатор запроса — нет. Используйте действие Event с точным URL события, а Login — с URL страницы входа. По умолчанию создание TMPT ожидает до 1.5 секунды, чтобы уже подготовленное решение могло вернуться сразу; для новой работы возвращается задача в ожидании. Задайте параметр строки запроса URL waitMs=0 для полностью асинхронного создания или значение вплоть до waitMs=75000 для более длительного ограниченного ожидания, затем проверьте статус задачи и опрашивайте его, если задача ещё не достигла конечного состояния. Токен — это исходное значение cookie tmpt. Назначьте Ticketmaster TMPT слоту безлимитного тарифа, чтобы включить эти задачи в свой тариф.
Асинхронный резервный сценарий
GET /v1/tasks/:id · 200
curl https://api.solvethree.com/v1/tasks/login_20260910_0001 \
-H "Authorization: Bearer $SOLVETHREE_API_KEY"{
"id": "login_20260910_0001",
"status": "ready",
"solution": {
"token": "03AFcWeA5…kQ2b",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) …",
"secChUa": "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\""
},
"durationMs": 1742
}Большинству интеграций этот запрос не нужен. Используйте его только в том случае, если после синхронного ожидания ответ на создание всё ещё имеет статус pending или solving, либо чтобы восстановить идемпотентную задачу после разрыва соединения. Kasada ожидает до 75 секунд, а reCAPTCHA — 15 секунд. TMPT по умолчанию ожидает до 1.5 секунды; используйте waitMs=0 для полностью асинхронного создания или явно задайте для TMPT waitMs со значением до 75 секунд.
Обработка ошибок
status · failed
{
"id": "login_20260910_0001",
"status": "failed",
"errorCode": "site-unreachable",
"error": "target page did not respond",
"durationMs": 9210
}Идентификационные данные в комплекте
Токен возвращается вместе с userAgent и secChUa, для которых он выдан. Отправляйте их вместе.
Неудачные решения бесплатны
Средства за задачу, завершившуюся со статусом failed, автоматически возвращаются на баланс.
Защита секретов
Токены, cookies, прокси и отпечатки браузера не попадают в списки задач и журналы.