Saltar al contenido principal
GET
/
v1
/
batches
/
{batch_id}
/
items
Obtener lista de elementos completados o fallidos opcionalmente con contenido para un lote específico
curl --request GET \
  --url https://api.olostep.com/v1/batches/{batch_id}/items \
  --header 'Authorization: Bearer <token>'
{
  "batch_id": "batch_abc123def456",
  "object": "list",
  "status": "completed",
  "items": [
    {
      "custom_id": "product-123",
      "retrieve_id": "ret_xyz789",
      "url": "https://example.com/product/123",
      "metadata": {
        "source": "catalog_sync",
        "priority": "high"
      }
    },
    {
      "custom_id": "product-456",
      "retrieve_id": "ret_abc456",
      "url": "https://example.com/product/456"
    }
  ],
  "items_count": 2
}
Metadatos: Si adjuntaste metadata a elementos individuales al crear el lote, se devolverá con cada elemento en la respuesta.

Autorizaciones

Authorization
string
header
requerido

Encabezado de autenticación Bearer del formato Bearer , donde es tu token de autenticación.

Parámetros de ruta

batch_id
string
requerido

El ID del lote para obtener elementos.

Parámetros de consulta

status
enum<string>

Estado de las URLs a obtener (completed o failed).

Opciones disponibles:
completed,
failed
cursor
integer

Cursor de paginación. Omite este parámetro en la primera solicitud. Para solicitudes posteriores, usa el valor cursor de la respuesta anterior. Consulta Paginación para más detalles.

limit
integer

Número de resultados a devolver (recomendado 10-50).

Respuesta

Respuesta exitosa con elementos del lote.

batch_id
string
object
string
status
string
items
object[]
items_count
integer
cursor
integer

Cursor de paginación. Presente cuando hay más resultados disponibles. Usa este valor en el parámetro cursor de la siguiente solicitud. Consulta Paginación para más detalles.