# Trabajos

Después de enviar un trabajo, consulta su estado y descarga el resultado.

## Consultar estado del trabajo

```http
GET /job/{id}
X-Fast-Api-Key: YOUR_API_KEY
```

Estados habituales:

| Estado | Significado |
| --- | --- |
| `queued` | El trabajo está esperando turno. |
| `running` | El trabajo se está procesando. |
| `succeeded` | El ZIP está listo. |
| `failed` | El trabajo falló; revisa el código de error estable. |
| `cancelled` | El trabajo fue cancelado. |

Consulta con reintentos progresivos. Un punto de partida práctico es cada 1 o 2 segundos mientras esté en cola o en ejecución, y luego con menos frecuencia tras varias respuestas sin cambios.

## Descargar resultado

```http
GET /job/{id}/download
X-Fast-Api-Key: YOUR_API_KEY
```

Descarga un ZIP cuando el trabajo ha terminado correctamente. El ZIP se elimina automáticamente después de la ventana de retención configurada.

## Cancelar trabajo

```http
POST /job/{id}/cancel
X-Fast-Api-Key: YOUR_API_KEY
```

La cancelación se intenta cuando el trabajo aún está en cola o en ejecución. Si un trabajo cobrado se cancela o falla después del débito, el reembolso sigue el estado de facturación del servicio.

## Eliminar trabajo

```http
DELETE /job/{id}
X-Fast-Api-Key: YOUR_API_KEY
```

Elimina los metadatos del trabajo y los artefactos almacenados cuando el trabajo es accesible para quien llama y el estado permite borrarlo.
