Synchroniser de nombreux produits

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

Jusqu'à 1000 produits par appel, avec les mêmes champs que l'endpoint unitaire. La réponse arrive tout de suite (202) : les lignes sont vérifiées immédiatement et écrites peu après, par blocs, sans ralentir la boutique. Pour un grand catalogue, faites plusieurs appels à la suite.

La réponse contient un import_id pour suivre l'avancement.

Une ligne erronée n'arrête pas les autres. Les lignes non valides sont listées tout de suite dans errors, avec leur position dans votre liste (index), le SKU et la raison.

Renvoyer tout le catalogue est sûr et rapide : les produits identiques sont comptés comme unchanged et ne sont pas réécrits.

import_key rend l'appel répétable : si vous le renvoyez après un timeout avec la même clé (sous 24 heures), vous récupérez le même import, pas un second.

Limites : 3 imports en cours par compte (au-delà, réponse 429 avec Retry-After), 20 appels bulk par minute, corps de la requête de 8 Mo au maximum, 20 000 produits par compte.

Paramètres

4 · 2 obligatoires

apikey obligatoire

Votre API Key (ou bien l'en-tête X-API-Key).

token facultatif

Token du compte. Obligatoire si vous en avez plusieurs.

products obligatoire

Liste de produits, avec les mêmes champs que l'endpoint unitaire. 1000 au maximum par appel ; chaque SKU une seule fois.

import_key facultatif

Votre identifiant de l'appel (80 caractères max.), pour pouvoir le répéter sans doublons.

Besoin d'aide pour l'intégration ? info@sendapp.live

Requête

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();

Réponse

{
  "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})."
}