Passer au contenu principal
GET
/
v1
/
batches
/
{batch_id}
/
items
Récupérer la liste des éléments complétés ou échoués éventuellement avec le contenu pour un lot spécifique
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
}

Documentation Index

Fetch the complete documentation index at: https://docs.olostep.com/llms.txt

Use this file to discover all available pages before exploring further.

Métadonnées : Si tu as attaché des métadonnées à des éléments individuels lors de la création du lot, elles seront renvoyées avec chaque élément dans la réponse.

Autorisations

Authorization
string
header
requis

En-tête d'authentification Bearer sous la forme Bearer , où est ton jeton d'authentification.

Paramètres de chemin

batch_id
string
requis

L'ID du lot pour lequel récupérer les éléments.

Paramètres de requête

status
enum<string>

Statut des URLs à récupérer (completed ou failed).

Options disponibles:
completed,
failed
cursor
integer

Curseur de pagination. Omettre ce paramètre lors de la première requête. Pour les requêtes suivantes, utiliser la valeur cursor de la réponse précédente. Voir Pagination pour plus de détails.

limit
integer

Nombre de résultats à retourner (recommandé 10-50).

Réponse

Réponse réussie avec les éléments du lot.

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

Curseur de pagination. Présent lorsqu'il y a plus de résultats disponibles. Utilise cette valeur dans le paramètre cursor de la prochaine requête. Voir Pagination pour plus de détails.