NeuroCaptcha

getTaskResult

Возвращает статус задачи, а когда она готова — токен, стоимость и время. Результат хранится 10 минут.

На этой странице
Метод
POST https://neurocaptcha.com/getTaskResult

Запрос#

clientKey
stringобязательный
Ваш ключ API.
taskId
integerобязательный
taskId из createTask. Число, а не строка.

Пример#

import requests

response = requests.post("https://neurocaptcha.com/getTaskResult", json={
    "clientKey": "YOUR_API_KEY",
    "taskId": 7781,
}, timeout=30)
print(response.json())

Ответ#

В работе#

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

Готово#

ready
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AFcWeA6Z3vq0VhGm1oS8r0bAxKk4…",
    "userAgent": ""
  },
  "cost": "0.000600",
  "ip": "198.51.100.7",
  "createTime": 1793370000,
  "endTime": 1793370007,
  "solveCount": 1
}
status
string
processing или ready.
solution.gRecaptchaResponse
string
Токен.
solution.userAgent
string
userAgent из задачи (пустой, если вы его не передавали).
solution.cookies
object
Cookies, выставленные при решении, если они есть.
cost
string
Списанная сумма в долларах, 6 знаков после точки (0.000000 для test-ключей).
ip
string
IP-адрес, с которого создана задача.
createTime
integer
Когда создана задача, Unix-время.
endTime
integer
Когда решена, Unix-время.
solveCount
integer
Сколько попыток решения потребовалось.

Ошибка#

Неудачная задача отвечает своим кодом ошибки и не списывается. Создайте новую:

error
{
  "errorId": 12,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "the task could not be solved"
}

Опрос#

  • Опрашивайте каждую задачу раз в 2–3 секунды; чаще — не быстрее.
  • Всего на ключ — до 50 вызовов getTaskResult в секунду; сверх этого ERROR_TOO_MUCH_REQUESTS.
  • Останавливайтесь на ready или на первой ошибке — завершённая задача больше не меняется.
  • Результат хранится 10 минут после готовности, затем ответ — ERROR_NO_SUCH_CAPCHA_ID.
  • Если задач параллельно много, вебхуки экономят запросы.