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.
- 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.
- Cada tarea puede consultarse dentro de los 5 minutos posteriores a su creación y se perderá después de que transcurra ese tiempo.
- 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ámetros | Tipo | Requerido | Descripción |
|---|---|---|---|
| clientKey | string | Yes | Clave de la cuenta del cliente, se puede encontrar aquí |
| taskId | string | Yes | ID 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ámetros | Tipo | Descripción |
|---|---|---|
| errorId | Integer | Mensaje de error: 0 - sin error 1 - con error |
| errorCode | String | errorCode: lista completa de errores |
| errorDescription | String | Descripción del Error |
| status | String | • 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 |
| solution | Object | Datos del resultado de la tarea. Diferentes para cada tipo de tarea |
Especificaciones de la Respuesta
Éxito en el reconocimiento: Cuando
errorIdes igual a0ystatuses igual aready, el resultado se encuentra ensolution.Identificación en curso: Cuando
errorIdes igual a0ystatuses igual aprocessing, por favor, inténtalo nuevamente en 3 segundos.Error: Cuando
errorIdes mayor que0, conoce la información del error segúnerrorDescription.
CapSolver