Thunderbit Open API home page
SoporteConsola API
Distill

Obtener Estado del Trabajo de Destilación por Lotes

GET
/batch/distill/{id}
Obtener Estado del Trabajo de Destilación por Lotes

Verifica el estado y recupera los resultados de un trabajo de destilación por lotes.

Estados de Respuesta:

  • processing: El trabajo está ejecutándose actualmente
  • completed: Todas las URLs han sido procesadas
  • failed: El trabajo encontró un error fatal

Mejores Prácticas de Consulta:

  • Consulta cada 5-10 segundos para trabajos con <10 URLs
  • Consulta cada 30-60 segundos para trabajos más grandes
  • Usa webhooks para mejor eficiencia

Resultados Parciales: Puedes recuperar resultados completados mientras el trabajo aún está procesando. El array results contendrá todas las URLs procesadas hasta el momento.

Autorización

YOUR_API_KEY
AutorizaciónBearer <token>

Obtén tu API key del Thunderbit Dashboard. Formato del encabezado: Authorization: Bearer YOUR_API_KEY

En: header

Parámetros de ruta

id*stringrequerido

ID de tarea por lotes

Parámetros de consulta

pageintegerpredeterminado:0

Page number (0-based), default 0

Rango requerido:0 <= x
pageSizeintegerpredeterminado:20

Number of results per page (1-100), default 20

Rango requerido:1 <= x <= 100

Respuesta

application/json

Success response

successboolean
Ejemplo:
true
dataobject
Mostrar atributos hijos
idstring
Ejemplo:batch_abc123
statusstring
Valor en"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
Ejemplo:COMPLETED
totalinteger
Ejemplo:
3
completedinteger
Ejemplo:
2
failedinteger

Number of failed URLs

Ejemplo:
1
creditsUsedinteger
Ejemplo:
2
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)

resultsobject[]
Mostrar atributos hijos
indexinteger

Zero-based index of this URL in the original batch

Ejemplo:
0
urlstring

The processed URL

statusstring

Per-URL processing status: PENDING, PROCESSING, SUCCEEDED, or FAILED

Valor en"PENDING" | "PROCESSING" | "SUCCEEDED" | "FAILED"
Ejemplo:SUCCEEDED
markdownstring

Extracted markdown content (present when status is SUCCEEDED)

errorobject

Error detail (present when status is FAILED)

Mostrar atributos hijos
codestring
Ejemplo:DISTILL_FAILED
messagestring
Ejemplo:Failed to fetch the page: Connection timeout

Paginación

  • pageSize tiene un valor predeterminado de 20 y un máximo de 100 por solicitud. Establece pageSize=100 para obtener el máximo en cada llamada.
  • Para lotes con más de 100 resultados, incrementa page (basado en 0) hasta que results esté vacío: page=0, page=1, etc.
  • El campo total de la respuesta indica el número total de resultados del lote.

On this page

Paginación