Skip to content
On this page
Home
>API
>createTask: Создать задачу

createTask: создание задачи

::: предупреждение Создает задачу для решения выбранного типа капчи.

Укажите тип капчи в параметре.

Например: ImageToTextTask

Вы можете просмотреть все поддерживаемые типы задач :::

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

json
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

{
    "clientKey":"YOUR_API_KEY",
    "appId": "ИД_ПРИЛОЖЕНИЯ",
    "task": {
        "type":"ImageToTextTask",// Укажите ниже тип, который необходимо идентифицировать
        "body":"ИЗОБРАЖЕНИЕ_BASE64"
    }
}

Параметры запроса

ПараметрыТипОбязательноОписание
clientKeyStringYesКлюч клиентского аккаунта, можно найти в панели управления
appIdStringNoИдентификатор разработчика вашего приложения, который вы можете получить в разделе разработчика панели управления
taskObjectYesОбъект задачи
callbackUrlStringNoТокен будет отправлен (POST) на этот конечный точка

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

Пример ответа асинхронной задачи

Когда задача создана как задача на токен или специальная асинхронная задача, результат задачи получается через команду getTaskResult

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // Сохраните этот идентификатор для следующего шага
}

Пример ответа синхронной задачи

Если тип задачи - это распознавание изображения, распознавание голоса или какие-либо другие специальные задачи, результат задачи возвращается непосредственно. Это можно определить по тому, равен ли status значению ready

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "status": "ready",
    "solution": {
        "text": "44795sds"
    },
    "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b",
}

Структура ответа

ПараметрыТипОписание
errorIdIntegerКод ошибки:
0 - нет ошибки
1 - с ошибкой
errorCodeStringТаблица кодов ошибок
errorDescriptionStringОписание ошибки
statusStringвозвращает статус, который может быть только null или готов
solutionObjectРезультат синхронной задачи
taskIdStringИдентификатор созданной задачи, Получить результат задачи