API de Integração · v1
OnmIA API Docs
Integre seu ERP, PDV ou middleware à OnmIA. Uma superfície REST server-to-server para catálogo, estoque, pedidos e webhooks assinados — pensada para confiabilidade e idempotência.
Comece por aqui
IntroduçãoAmbientes, feature flag, base URL e o namespace /integration/v1.Ler guia AutenticaçãoHeader X-API-Key (onmia_<key_id>_<secret>), ordem de validação e scopes.Ler guia CatálogoPOST /products/bulk — upsert de até 500 produtos por external_id.Ler guia Estoque e preçoPATCH /stock — set absoluto, decimal numeric(12,3) por loja.Ler guia PedidosCriar, consultar e atualizar status com idempotência por external_order_id.Ler guia WebhooksEventos outbound assinados HMAC-SHA256, com retry e validação anti-SSRF.Ler guia
Pronto para integrar?
A emissão da chave de API é feita no painel admin da OnmIA. Com a chave em mãos, valide o fluxo completo contra a loja de teste antes do go-live.
Ver a sequência de integraçãoOnmIA · Inteligência em Vendas