Sincronizar muitos produtos

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

Até 1000 produtos por chamada, com os mesmos campos do endpoint individual. A resposta chega de imediato (202): as linhas são verificadas logo e escritas pouco depois, por blocos, sem tornar a loja mais lenta. Para um catálogo grande faça várias chamadas seguidas.

Com a resposta recebe um import_id para acompanhar o progresso.

Uma linha errada não trava as outras. As linhas inválidas são listadas de imediato em errors, com a posição na sua lista (index), o SKU e o motivo.

Voltar a enviar todo o catálogo é seguro e rápido: os produtos iguais contam como unchanged e não são reescritos.

import_key torna a chamada repetível: se a reenviar após um timeout com a mesma chave (em 24 horas) recebe a mesma importação, não uma segunda.

Limites: 3 importações em curso por conta (acima disso, resposta 429 com Retry-After), 20 chamadas bulk por minuto, corpo do pedido no máximo 8 MB, 20.000 produtos por conta.

Parâmetros

4 · 2 obrigatórios

apikey obrigatório

A sua API Key (em alternativa: o cabeçalho X-API-Key).

token opcional

Token da conta. Obrigatório se tiver mais do que uma.

products obrigatório

Lista de produtos, com os mesmos campos do endpoint individual. No máximo 1000 por chamada; cada SKU uma só vez.

import_key opcional

Um identificador seu para a chamada (máx. 80 caracteres), para a poder repetir sem duplicados.

Precisa de ajuda com a integração? info@sendapp.live

Pedido

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

Resposta

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