Sincronizza molti prodotti

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

Fino a 1000 prodotti per chiamata, con gli stessi campi dell'endpoint singolo. La risposta arriva subito (202): le righe vengono controllate al momento e scritte poco dopo, a blocchi, senza rallentare il negozio. Per un catalogo grande fai più chiamate di fila.

Con la risposta ricevi un import_id per seguire l'avanzamento.

Una riga sbagliata non ferma le altre. Le righe non valide sono elencate subito in errors, con la posizione nella tua lista (index), lo SKU e il motivo.

Rimandare tutto il catalogo è sicuro e veloce: i prodotti uguali vengono contati come unchanged e non vengono riscritti.

import_key rende la chiamata ripetibile: se la reinvii dopo un timeout con la stessa chiave (entro 24 ore) ricevi lo stesso import, non un secondo.

Limiti: 3 import in corso per account (oltre, risposta 429 con Retry-After), 20 chiamate bulk al minuto, corpo della richiesta al massimo 8 MB, 20.000 prodotti per account.

Parametri

4 · 2 obbligatori

apikey obbligatorio

La tua API Key (in alternativa: header X-API-Key).

token opzionale

Token dell'account. Obbligatorio se ne hai più di uno.

products obbligatorio

Lista di prodotti, con gli stessi campi dell'endpoint singolo. Massimo 1000 per chiamata; lo stesso SKU una sola volta.

import_key opzionale

Un tuo identificativo della chiamata (max 80 caratteri), per poterla ripetere senza doppioni.

Serve aiuto con l'integrazione? info@sendapp.live

Richiesta

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

Risposta

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