API de Webhooks
A API de Webhooks entrega eventos do Ecossistema (pedidos, estoque, frete e pagamentos) na sua aplicacao em tempo quase real, com assinatura de seguranca e reentrega automatica. Para comecar, registre uma URL em POST /webhooks/assinaturas.
O que é API de Webhooks?
A API de Webhooks inverte o fluxo de integracao: em vez de sua aplicacao consultar a Precode repetidamente (polling), a Precode envia uma requisicao HTTP para uma URL sua sempre que um evento relevante acontece. Isso reduz latencia e carga, mantendo seus sistemas sincronizados quase em tempo real.
Recursos principais
- POST /webhooks/assinaturas — registra uma URL de destino (endpoint) e os tipos de evento desejados.
- GET /webhooks/assinaturas — lista as assinaturas ativas e seu status de saude.
- DELETE /webhooks/assinaturas/{id} — remove uma assinatura.
- GET /webhooks/entregas — consulta o historico de entregas, tentativas e respostas para auditoria e depuracao.
Casos de uso
Disparar o faturamento assim que um pedido e pago, atualizar o ERP quando o estoque muda, notificar o cliente a cada evento de rastreamento e acionar a conciliacao financeira quando um repasse e confirmado.
Como funciona a integração
Cada evento e enviado como JSON sobre HTTPS via POST. A entrega inclui uma assinatura HMAC em cabecalho para que voce valide a autenticidade do payload. Sua URL deve responder 2xx rapidamente; caso contrario, a Precode aplica reentrega automatica com backoff exponencial ate o limite configurado.
Os webhooks complementam as demais APIs: assine eventos da API de Pedidos, da API de Produtos e Estoque e da API de Frete. Veja a Biblioteca Tecnica para a lista de tipos de evento, o esquema de payloads e como validar a assinatura.
Documentação técnica
Consulte a Biblioteca Técnica para a referência completa de API de Webhooks: endpoints REST, autenticação, webhooks, exemplos de código, coleção Postman e especificação OpenAPI.
Quer integrar API de Webhooks com o Ecossistema Precode?
Fale com um especialista Precode e receba um plano de integração para API de Webhooks, com marketplaces, ERPs, transportadoras e gateways conectados em um só hub.