Archivos y lotes

Listar batches

Lista los batches en el Workspace actual.

GET
/v1/batches

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: 20
Nú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: desc
asc o desc, por fecha de creación.

Ejemplo

Solicitud

cURL
curl -X GET "https://api.tokenlab.sh/v1/batches?limit=20" \
  -H "Authorization: Bearer sk-your-api-key"

Ejemplo de respuesta

Respuesta

200 OK
{
  "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.

Rango1 <= value <= 100
predeterminado20
after?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