Passer au contenu principal
GET
/
v1
/
batches
/
{batch_id}
/
items
Récupérer la liste des éléments complétés ou échoués avec contenu optionnellement 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
}
Métadonnées : Si vous avez attaché des metadata à 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. Omet ce paramètre lors de la première requête. Pour les requêtes suivantes, utilise 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 des éléments de 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.