Documentação técnica do Domus
O Domus envia; o seu sistema recebe. Você implementa um endpoint HTTP, nós fazemos
POST nele quando algo muda, e você responde 2xx.
Não há nada para você chamar na nossa API — a integração é de via única, e nada volta.
Se você é da igreja e quer saber como usar o sistema, o lugar é a Central de Ajuda.
O que existe hoje
Webhook de coberturas
Avisa um sistema parceiro sempre que uma rede, área, setor ou Life Group é criado, alterado, arquivado ou desarquivado. Via única: o Domus envia, nada volta.
- Comece aqui — um endpoint funcionando em quinze minutos
- Eventos e payload
- Verificar a assinatura
- Entrega e retentativa
- O segredo e a rotação
- Problemas comuns
- Checklist de implementação
O contrato em OpenAPI 3.1 está em
webhook-de-coberturas.yaml — dá para gerar tipos e
cliente a partir dele.
Como esta documentação se mantém honesta
O contrato não é escrito duas vezes. O arquivo OpenAPI é a fonte, e a integração contínua valida um payload real do nosso código contra ele a cada mudança: campo novo, campo renomeado ou tipo diferente fazem o build falhar.
Isso não é zelo abstrato. Numa versão anterior desta mesma documentação, um evento estava descrito e o código nunca o enviava. A validação existe para que a próxima vez que isso acontecer, quem descubra seja o nosso build — e não o time do outro lado, no dia da virada.