Viele Produkte synchronisieren

POST https://app.sendapp.ai/api/products/bulk

Bis zu 1000 Produkte pro Aufruf, mit denselben Feldern wie der Einzel-Endpoint. Die Antwort kommt sofort (202): Die Zeilen werden sofort geprüft und kurz danach blockweise geschrieben, ohne den Shop zu verlangsamen. Für einen großen Katalog mehrere Aufrufe nacheinander senden.

Die Antwort enthält eine import_id, um den Fortschritt zu verfolgen.

Eine fehlerhafte Zeile hält die anderen nicht auf. Ungültige Zeilen werden sofort in errors aufgeführt, mit ihrer Position in Ihrer Liste (index), der SKU und dem Grund.

Den ganzen Katalog erneut zu senden ist sicher und schnell: Unveränderte Produkte zählen als unchanged und werden nicht neu geschrieben.

import_key macht den Aufruf wiederholbar: Senden Sie ihn nach einem Timeout mit demselben Schlüssel erneut (innerhalb von 24 Stunden), erhalten Sie denselben Import zurück, keinen zweiten.

Grenzen: 3 laufende Importe pro Konto (darüber Antwort 429 mit Retry-After), 20 Bulk-Aufrufe pro Minute, Anfragekörper höchstens 8 MB, 20.000 Produkte pro Konto.

Parameter

4 · 2 Pflichtfelder

apikey erforderlich

Ihr API Key (alternativ: der Header X-API-Key).

token optional

Konto-Token. Pflicht, wenn Sie mehrere haben.

products erforderlich

Liste von Produkten, mit denselben Feldern wie der Einzel-Endpoint. Höchstens 1000 pro Aufruf; jede SKU nur einmal.

import_key optional

Ihre eigene Kennung des Aufrufs (max. 80 Zeichen), um ihn ohne Duplikate wiederholen zu können.

Brauchen Sie Hilfe bei der Integration? info@sendapp.live

Anfrage

curl -X POST 'https://app.sendapp.ai/api/products/bulk' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "YOUR_ACCOUNT_TOKEN",
    "import_key": "feed-2026-09-18",
    "products": [
      { "sku": "MUG-01", "name": "Tazza", "price": 9, "stock": 120 },
      { "sku": "TSH-001", "price": 22.50 }
    ]
  }'

<?php
// Whole catalogue, 1000 products per call, then follow each import.
foreach (array_chunk($catalogue, 1000) as $i => $chunk) {
    $ch = curl_init('https://app.sendapp.ai/api/products/bulk');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode([
            'token'      => 'YOUR_ACCOUNT_TOKEN',
            'import_key' => 'feed-' . date('Y-m-d') . '-' . $i,
            'products'   => $chunk,
        ]),
    ]);
    $res = json_decode(curl_exec($ch), true);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($code === 429) { sleep(30); /* send this chunk again */ }
}

const res = await fetch('https://app.sendapp.ai/api/products/bulk', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    token: 'YOUR_ACCOUNT_TOKEN',
    products: catalogue.slice(0, 1000),
  }),
});
const { import_id } = await res.json();

Antwort

{
  "status": "success",
  "accepted": 1,
  "rejected": 1,
  "import_id": "imp_eggsipzvalu6xlkqjfecphki",
  "state": "queued",
  "total": 1,
  "processed": 0,
  "created": 0,
  "updated": 0,
  "unchanged": 0,
  "failed": 1,
  "images": { "status": "none", "total": 0, "done": 0, "failed": 0 },
  "errors": [
    { "index": 1, "sku": "MUG-02", "error": "The price field must be a number." }
  ],
  "started_at": null,
  "finished_at": null,
  "created_at": "2026-09-18T09:02:11+00:00"
}

{
  "status": "error",
  "message": "There are already 3 imports in progress for this account: wait for one to finish (check GET /api/products/imports/{import_id})."
}