## O que esta secção resolve

Define como desenhar integrações previsíveis num modelo `webhook-first`, reduzindo inconsistências entre estados temporários e estado final.

## Princípios de contrato

- Pedidos mutáveis devem usar idempotência.
- Eventos são a fonte final de confirmação operacional.
- Versionamento e naming devem ser explícitos por domínio.

## Percurso recomendado

<Steps>
  <Step title="1) Ler contratos base">Começa em [API Essentials](/docs/apis-events/api-essentials).</Step>
  <Step title="2) Definir semântica de eventos">Aplica [Convenções de eventos](/docs/apis-events/event-conventions).</Step>
  <Step title="3) Fechar segurança de execução">Valida [Autenticação e idempotência](/docs/apis-events/authentication-idempotency).</Step>
  <Step title="4) Consolidar racional arquitetural">Documenta trade-offs em [Arquitetura webhook-first](/docs/apis-events/webhook-first-architecture).</Step>
</Steps>

## Critérios de qualidade de integração

| Critério | Meta operacional |
| --- | --- |
| Duplicados processados | 0 efeitos laterais duplicados |
| Retries com sucesso | 100% com limite e backoff definido |
| Eventos sem schema | 0 em produção |
| Erros 5xx persistentes | Sem backlog fora da janela de SLO |