Vai al contenuto principale
GET
/
v1
/
batches
/
{batch_id}
/
items
Recupera l'elenco degli elementi completati o falliti opzionalmente con contenuto per un batch specifico
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
}
Metadati: Se hai allegato metadata a singoli elementi durante la creazione del batch, verrà restituito con ciascun elemento nella risposta.

Autorizzazioni

Authorization
string
header
obbligatorio

Intestazione di autenticazione Bearer della forma Bearer , dove è il tuo token di autenticazione.

Parametri del percorso

batch_id
string
obbligatorio

L'ID del batch per cui recuperare gli elementi.

Parametri della query

status
enum<string>

Stato degli URL da recuperare (completed o failed).

Opzioni disponibili:
completed,
failed
cursor
integer

Cursore di paginazione. Ometti questo parametro alla prima richiesta. Per le richieste successive, usa il valore cursor dalla risposta precedente. Vedi Paginazione per i dettagli.

limit
integer

Numero di risultati da restituire (consigliato 10-50).

Risposta

Risposta riuscita con elementi del batch.

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

Cursore di paginazione. Presente quando ci sono più risultati disponibili. Usa questo valore nel parametro cursor della prossima richiesta. Vedi Paginazione per i dettagli.