getTaskResult: solicitar resultado de tarea
Cuando la tarea iniciada por createTask es una tarea asíncrona, obtenga el resultado de la tarea asíncrona a través de getTaskResult.
- El número máximo de solicitudes de consulta para cada tarea es 120. Cuando se excede el número de solicitudes de consulta, los resultados de la tarea se perderán.
- Cada tarea puede ser consultada dentro de los 5 minutos posteriores a su creación, y se perderá después de que se exceda el tiempo.
- El resultado del reconocimiento obtenido por este método, dependiendo de la carga del sistema, obtendrá el resultado en un intervalo de tiempo de 1s a 30s.
ADVERTENCIA
Tenga en cuenta que no todas las tareas necesitan obtener resultados de esta manera. Las siguientes dos tareas necesitan revisar los documentos.
- Tareas de clase de identificación, ImageToText, etc., que se sincronizan directamente a través de los resultados de retorno de createTask
Solicitud de ejemplo
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 creado por el método createTask
}Parámetros de solicitud
| Parámetros | Tipo | Requerido | Descripción |
|---|---|---|---|
| clientKey | string | Sí | Clave de la cuenta del cliente, se puede encontrar aquí |
| taskId | string | Sí | ID creado por el método createTask |
Respuesta de ejemplo
{
"errorId": 0,
"taskId": "...",
"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 - En espera • processing - En procesamiento/identificación • ready - La identificación está completa y el resultado se encuentra en el parámetro solution |
| solution | Object | Datos del resultado de la tarea. Diferente para cada tipo de tarea |
Especificación de la respuesta
-
Éxito del reconocimiento: Cuando
errorIdes igual a0ystatuses igual aready, el resultado está ensolution. -
Identificando: Cuando
errorIdes igual a0ystatuses igual aprocessing, por favor, inténtelo de nuevo en 3 segundos. -
Error: Cuando
errorIdes mayor que0, por favor, consulte la información del error segúnerrorDescription.