Trabajos
Después de enviar un trabajo, consulta su estado y descarga el resultado.
Consultar estado del trabajo
GET /job/{id}
X-Fast-Api-Key: YOUR_API_KEYEstados 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.
Algunas selecciones de PDF sin contenido pueden terminar como failed aunque el proceso haya funcionado como estaba previsto. El código estable extract.pdf.no_markdown_content_found indica que el motor de Markdown solo encontró marcadores estructurales, mientras que extract.pdf.no_ocr_text_found indica que el OCR no encontró texto legible. Estos resultados no generan ningún artefacto y no se cobran.
Descargar resultado
GET /job/{id}/download
X-Fast-Api-Key: YOUR_API_KEYDescarga 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
POST /job/{id}/cancel
X-Fast-Api-Key: YOUR_API_KEYLa 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
DELETE /job/{id}
X-Fast-Api-Key: YOUR_API_KEYElimina los metadatos del trabajo y los artefactos almacenados cuando el trabajo es accesible para quien llama y el estado permite borrarlo.