Obtener una tarea.¶

Método¶

GET https://papi.afi.ai/api/v1/tenants/{tenant_id}/tasks/{task_id}

Descripción¶

Obtiene una tarea por su ID.

Mientras espera a que finalice, consulte su estado a intervalos que aumenten exponencialmente: empiece 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 hace falta consultar con más frecuencia: el estado almacenado en caché no se actualizará antes y hacerlo aumenta la probabilidad de errores HTTP 429 por la limitación de solicitudes.

Parámetros de ruta¶

tenant_id string obligatorio

ID del inquilino al que pertenece la tarea.

task_id string obligatorio

ID de la tarea solicitada.

curl

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 tarea.

id string

ID de la tarea.

resource_id string

ID 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 finales. El estado warnings indica que la tarea finalizó con advertencias que podrían requerir atención.

Ejemplo de respuesta¶

{
  "id": "string",
  "resource_id": "string",
  "status": "string"
}