funsolver

Документация

Справочник по API и руководство по интеграции

ОбзорFunCaptchaFunCaptcha ProxylessFunCaptcha BDACastlereCAPTCHA v2reCAPTCHA v2 EnterprisereCAPTCHA v3reCAPTCHA v3 EnterpriseTurnstilehCaptchaCloudflareImage→TextMath ImageFC ClassificationDataDome

Обзор

funsolver API

v2.0 · 2captcha-compatible

Один эндпоинт createTask + getTaskResult на любую поддерживаемую капчу — тип задаёшь в task.type. Авторизация по clientKey, тарификация только за успешные решения.

Базовый URL

https://api.funsolver.com

Как работает запрос

1createTask

Шлёшь задачу. В ответ — taskId.

2getTaskResult

Пинг каждые 1–2 секунды, пока статус не станет ready (или придёт ошибка).

3solution

Готовая задача отдаёт token и метаданные. Деньги списываются только при успехе.

Аутентификация

Каждый запрос обязан содержать clientKey. Создай его во вкладке API Keys.

Не делитесь ключом. Скомпрометированный — отозвать в дашборде.

Эндпоинты

POST/createTaskСоздать задачу
POST/getTaskResultЗабрать результат по taskId
POST/getBalanceУзнать баланс
GET/healthПроверка живости

getTaskResult

Один и тот же запрос для любого типа задачи.

HTTP
POST https://api.funsolver.com/getTaskResult
Content-Type: application/json

{
  "clientKey": "fsk_abc...",
  "taskId":    "11111111-2222-3333-4444-555555555555"
}

Ещё решается

JSON
{
  "errorId": 0,
  "status": "processing"
}

Готово

JSON
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "...",
    "userAgent": "Mozilla/5.0 ..."
  },
  "processingTime": 4.21
}

getBalance

HTTP
POST https://api.funsolver.com/getBalance
Content-Type: application/json

{ "clientKey": "fsk_abc..." }
JSON
{ "errorId": 0, "balance": 1240 }

Общие коды ошибок

ERROR_KEY_DOES_NOT_EXISTКлюч отсутствует, неверный или деактивирован.
ERROR_TASK_TYPE_REQUIREDПоле task.type обязательно.
ERROR_UNKNOWN_TASK_TYPEСервер не знает такого task.type.
ERROR_WEBSITE_URL_REQUIREDwebsiteURL is required.
ERROR_WEBSITE_PUBLIC_KEY_REQUIREDwebsitePublicKey is required.
ERROR_PROXY_REQUIREDЭтому типу капчи (CloudflareTask / FunCaptchaTask / CastleTask / DataDomeInterstitialTask / DataDomePreflightTask / RecaptchaV2Task / RecaptchaV2EnterpriseTask) обязательно нужен прокси: proxy="http://user:pass@host:port".
ERROR_PROXY_FORMATПрокси не парсится: неверная схема (нужна http/https/socks5), отсутствует порт или порт вне 1..65535. Чините URL и шлите снова.
ERROR_PROXY_UNREACHABLEПрокси не отвечает на TCP-коннект (таймаут 2с). Проверь host:port и что прокси жива — задача не отправлена, деньги не списаны.
ERROR_NO_BALANCEНа балансе не хватает на одно решение этой капчи.
ERROR_RATE_LIMITПревышен лимит запросов в минуту.
ERROR_NO_SOLVER_AVAILABLEСейчас ни один инстанс не подписан на этот тип капчи. Повтори позже или напиши в саппорт — расширим инфраструктуру.
ERROR_SOLVER_OVERLOADEDВсе воркеры этого типа заняты, очередь забита (>500 задач). Повтори через несколько секунд.
ERROR_TIMEOUTЗадача не была решена за 90 секунд — gateway отменил её. Деньги не списываются.
ERROR_TASK_ID_REQUIREDtaskId is required.
ERROR_NO_SUCH_TASKtaskId не найден (или истёк TTL).
ERROR_SERVICE_BUSYВременная проблема инфраструктуры. Повторите через секунду.
ERROR_CAPTCHA_UNSOLVABLEРешить не удалось — попробуй ещё раз.

Лимиты

Лимит запросов считается на пользователя (общий для всех его ключей). По умолчанию: 1200 createTask/мин и 70 одновременных задач. getTaskResult не ограничен.

Заметил ошибку в доке? Напиши в саппорт.
Для ИИ-агентов: машиночитаемый справочник — /llms.txt