Skip to content
On this page
Home
>API
>createTask: Crear Tarea

createTask: Creación de Tarea

WARNING

Crea una tarea para resolver un tipo de captcha seleccionado.

Especifica el tipo de captcha en los parámetros.

Por ejemplo: ImageToTextTask

Puedes ver todos los tipos de tarea admitidos.

Ejemplo de Solicitud

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

{
    "clientKey":"YOUR_API_KEY",
    "appId": "APP_ID",
    "task": {
        "type":"ImageToTextTask", // Escribe a continuación el tipo que necesitas identificar
        "body":"BASE64 image"
    }
}

Parámetros de la Solicitud

ParámetrosTipoRequeridoDescripción
clientKeyStringYesClave de la cuenta del cliente, se encuentra en el panel de control
appIdStringNoTu ID de desarrollador, solicítalo en la sección de desarrolladores del panel de control
taskObjectYesObjeto de la tarea
callbackUrlStringNoEl token se enviará (POST) a este punto final

Ejemplo de Respuesta

Ejemplo de respuesta de tarea asíncrona

Cuando se crea una tarea como una tarea de token o una tarea asíncrona especial, el resultado de la tarea se obtiene a través del comando getTaskResult.

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // Guarda este ID para el próximo paso
}

Ejemplo de respuesta de tarea síncrona

Si el tipo de tarea es reconocimiento de imágenes, reconocimiento de voz o alguna tarea especial, el resultado de la tarea se devuelve directamente. Se puede determinar si status es igual a ready.

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

Estructura de la Respuesta

ParámetrosTipoDescripción
errorIdIntegerMensaje de error:
0 - sin error
1 - con error
errorCodeStringTabla de códigos de error
errorDescriptionStringDescripción del error
statusStringdevuelve el estado, que solo puede ser nulo o ready
solutionObjectEl resultado de la tarea de sincronización
taskIdStringID de la tarea creada, Obtener resultados de la tarea