メインコンテンツへスキップ
GET
/
v1
/
batches
/
{batch_id}
/
items
Abgeschlossene oder fehlgeschlagene Elementeliste optional mit Inhalt für einen bestimmten Batch abrufen
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
}
メタデータ: バッチを作成する際に個々のアイテムにmetadataを添付した場合、レスポンス内の各アイテムにそのメタデータが返されます。

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

パスパラメータ

batch_id
string
必須

Die ID des Batches, für den Elemente abgerufen werden sollen.

クエリパラメータ

status
enum<string>

Status der URLs, die abgerufen werden sollen (completed oder failed).

利用可能なオプション:
completed,
failed
cursor
integer

Paginierungscursor. Lassen Sie diesen Parameter bei der ersten Anfrage weg. Für nachfolgende Anfragen verwenden Sie den cursor-Wert aus der vorherigen Antwort. Siehe Pagination für Details.

limit
integer

Anzahl der zurückzugebenden Ergebnisse (empfohlen 10-50).

レスポンス

Erfolgreiche Antwort mit Batch-Elementen.

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

Paginierungscursor. Vorhanden, wenn weitere Ergebnisse verfügbar sind. Verwenden Sie diesen Wert im cursor-Parameter der nächsten Anfrage. Siehe Paginierung für Details.