Archivos y lotes
Listar batches
Lista los batches en el Workspace actual.
Descripción general
Devuelve los batches creados a través de POST /v1/batches en el Workspace actual, los más recientes primero. Los Message Batches se listan mediante Listar Message Batches.
Parámetros de consulta
limitintegerquerypredeterminado:
20Número de batches a devolver, de 1 a 100.
afterstringquery
Cursor de ID de batch: devuelve los batches posteriores a este. Utilice el
last_id de la página anterior. No se puede combinar con before.beforestringquery
Cursor de ID de batch: devuelve los batches anteriores a este. No se puede combinar con
after.orderstringquerypredeterminado:
descasc o desc, por fecha de creación.Solicitud
curl -X GET "https://api.tokenlab.sh/v1/batches?limit=20" \
-H "Authorization: Bearer sk-your-api-key"Respuesta
{
"object": "list",
"data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }],
"first_id": "batch_abc123",
"last_id": "batch_abc123",
"has_more": false
}Campos importantes
objectstring
Siempre
list.dataarray
Batches.
statusstring
Estado de cada batch.
has_moreboolean
Hay más resultados disponibles cuando
has_more es true.Autorización
BearerAuth AuthorizationBearer <token>
Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de consulta
limit?integer
Número de batches a devolver. Predeterminado 20.
Rango
1 <= value <= 100predeterminado
20after?string
Cursor de ID de batch: devuelve batches después de este. No se puede combinar con before.
before?string
Cursor de ID de batch: devuelve batches antes de este. No se puede combinar con after.
order?string
Orden de clasificación por tiempo de creación.
predeterminado
"desc"Valores permitidos
- "asc"
- "desc"
Respuesta
application/json
application/json
application/json