O que você consegue fazer
Upsert idempotente
Cada produto identificado por
(externalSystem, externalId) — sem se preocupar com
IDs internos da Voop.Bulk import 100k+
Upload de JSONL (até 100MB) com processamento assíncrono e relatório de erros por linha.
Imagens por URL
Cliente envia URLs; a Voop baixa de forma assíncrona com cache via ETag.
Webhooks outbound
Receba eventos em tempo real quando produtos/estoque mudam, com assinatura HMAC.
Por que essa API existe
O catálogo da Voop é agnóstico: ele alimenta IA conversacional, perfis digitais públicos, helpdesk com cards de produto, e mais — tudo sem que o catálogo precise saber desses módulos. Isso significa que você gerencia os produtos no seu sistema, e a Voop vira o hub para todos os usos downstream. Sem duplicação manual, sem divergência.Princípios
Idempotência por externalId
Re-enviar o mesmo payload não cria duplicatas e não gera writes se nada mudou.
O backend mantém um
contentHash interno para detectar mudanças reais.Mídia depois do produto
Itens ficam disponíveis imediatamente para a IA e demais módulos. Imagens chegam em
background e são deduplicadas globalmente por
fileHash.Falha visível, nunca silenciosa
Erros de validação, conflitos e falhas de ingest aparecem na resposta da API e no
dashboard. Webhooks de
import.failed / media.ingestion_failed notificam você.Próximos passos
Autenticação
Crie sua primeira API key no Developer Portal.
Idempotência
Entenda como funciona o
contentHash — base do upsert.Carga inicial 100k
Receita completa de migração inicial de catálogo grande.
API Reference
Toda a referência interativa — gerada da spec OpenAPI.