Skip to content
On this page
Home
>API
>getTaskResult: Resultado de la Tarea

getTaskResult: solicitar el resultado de una tarea

Cuando la tarea iniciada por createTask es una tarea asincrónica, obtén el resultado asincrónico de la tarea a través de getTaskResult.

  1. El número máximo de solicitudes de consulta para cada tarea es de 120. Cuando el número de solicitudes de consulta excede este límite, los resultados de la tarea se perderán.
  2. Cada tarea puede consultarse dentro de los 5 minutos posteriores a su creación y se perderá después de que transcurra ese tiempo.
  3. El resultado de reconocimiento obtenido mediante este método, dependiendo de la carga del sistema, se obtendrá en un intervalo de tiempo de 1 a 30 segundos.

WARNING

Ten en cuenta que no todas las tareas necesitan obtener resultados de esta manera. Las dos siguientes tareas necesitan consultar los documentos.

  • Tareas de clasificación de identificación, como ImageToText, etc., que se sincronizan directamente a través de createTask y devuelven resultados.

Ejemplo de solicitud

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

{
    "clientKey":"YOUR_API_KEY",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // ID creada por el método createTask
}

Parámetros de la Solicitud

ParámetrosTipoRequeridoDescripción
clientKeystringYesClave de la cuenta del cliente, se puede encontrar aquí
taskIdstringYesID creado por el método createTask

Ejemplo de respuesta

json
{
    "errorId": 0,
    "solution": {
        "userAgent": "xxx",
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
    },
    "status": "ready"
}

Estructura de la Respuesta

ParámetrosTipoDescripción
errorIdIntegerMensaje de error:
0 - sin error
1 - con error
errorCodeStringerrorCode: lista completa de errores
errorDescriptionStringDescripción del Error
statusString• idle - Esperando
• processing - En proceso de identificación
• ready - La identificación está completa y el resultado se encuentra en el parámetro de solución
solutionObjectDatos del resultado de la tarea. Diferentes para cada tipo de tarea

Especificaciones de la Respuesta

  • Éxito en el reconocimiento: Cuando errorId es igual a 0 y status es igual a ready, el resultado se encuentra en solution.

  • Identificación en curso: Cuando errorId es igual a 0 y status es igual a processing, por favor, inténtalo nuevamente en 3 segundos.

  • Error: Cuando errorId es mayor que 0, conoce la información del error según errorDescription.

    errorCode: lista completa de errores