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
errorId
es igual a0
ystatus
es igual aready
, el resultado está ensolution
. -
Identificando: Cuando
errorId
es igual a0
ystatus
es igual aprocessing
, por favor, inténtelo de nuevo en 3 segundos. -
Error: Cuando
errorId
es mayor que0
, por favor, consulte la información del error segúnerrorDescription
.