Obtener una tarea.¶
Método¶
GET https://papi.afi.ai/api/v1/tenants/{tenant_id}/tasks/{task_id}
Descripción¶
Obtiene un objeto de tarea mediante su identificador.
Consulte el estado de la tarea a intervalos con un aumento exponencial mientras espera a que finalice: comience con 15 segundos y duplique el intervalo hasta un máximo de 4 minutos (15 s, 30 s, 60 s, 2 min, 4 min). No es necesario consultar con más frecuencia; el estado almacenado en caché no cambiará antes y hacerlo aumenta la probabilidad de errores HTTP 429 debido a los límites de frecuencia.
Parámetros de ruta¶
|
tenant_id
string
obligatorio
Identificador del inquilino propietario de la tarea. |
|
task_id
string
obligatorio
Identificador de la tarea que se obtendrá. |
curl -X GET \
-H 'Authorization: {api-key}' \
https://papi.afi.ai/api/v1/tenants/{tenant_id}/tasks/{task_id}
Esquema de respuesta correcta (200)¶
|
object
Task describe una única tarea. |
|
id
string
Identificador de la tarea. |
|
resource_id
string
Identificador del recurso al que está asociada la tarea. |
|
status
string
Estado de la tarea. Valores válidos: `open`, `inprogress`, `done`, `failed`, `suspended`, `warnings`, `canceled`. Los estados `done`, `failed`, `warnings` y `canceled` son terminales. El estado `warnings` indica que la tarea finalizó con advertencias que podrían requerir atención. |