# Voop API

## Docs

- [API Reference](https://docs.voop.work/api-reference/introduction.md): Referência interativa gerada da spec OpenAPI
- [Autenticação](https://docs.voop.work/authentication.md): API keys, escopos e ambientes (live / test)
- [Bulk Import](https://docs.voop.work/concepts/bulk-import.md): JSONL streaming para cargas de 100k+ itens
- [Items](https://docs.voop.work/concepts/items.md): Estrutura, campos canônicos, e resolução de category/brand
- [Mídia](https://docs.voop.work/concepts/media.md): Pipeline assíncrono de ingestão de imagens — URL → R2 com dedup global
- [Webhooks](https://docs.voop.work/concepts/webhooks.md): Eventos outbound, assinatura HMAC, retries e auto-disable
- [Erros](https://docs.voop.work/errors.md): Formato padrão de erros da API
- [Idempotência](https://docs.voop.work/idempotency.md): Como upsert por externalId funciona — contentHash, unchanged, dedup de mídia
- [Introdução](https://docs.voop.work/introduction.md): Voop Catalog API — sincronize seu catálogo de produtos via REST
- [Rate Limits](https://docs.voop.work/rate-limits.md): Tiers, headers de resposta e estratégia de retry
- [Integração com ERP genérico](https://docs.voop.work/recipes/erp-integration.md): Padrão para conectar TOTVS, Bling, Tiny, ERP custom à Voop
- [Receber webhooks com segurança](https://docs.voop.work/recipes/handle-webhooks.md): Servidor Node.js de exemplo com verificação HMAC e idempotência
- [Sync incremental contínuo](https://docs.voop.work/recipes/incremental-sync.md): Mantenha o catálogo Voop sempre em dia com mudanças no seu sistema
- [Carga inicial de 100k produtos](https://docs.voop.work/recipes/initial-load-100k.md): Receita end-to-end para migrar um catálogo grande para a Voop

## OpenAPI Specs

- [openapi](https://docs.voop.work/api-reference/openapi.json)