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
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
{
"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
errorId
es igual a0
ystatus
es igual aready
, el resultado se encuentra ensolution
. -
Identificación en curso: Cuando
errorId
es igual a0
ystatus
es igual aprocessing
, por favor, inténtalo nuevamente en 3 segundos. -
Error: Cuando
errorId
es mayor que0
, conoce la información del error segúnerrorDescription
.