## Qué resuelve esta sección

Define cómo construir integraciones previsibles en un modelo `webhook-first`, reduciendo divergencias entre estados temporales y estado final.

## Principios de contrato

- Las operaciones mutables deben usar idempotencia.
- Los eventos son la fuente final de verdad operacional.
- Versionado y naming deben ser explícitos por dominio.

## Ruta recomendada

<Steps>
  <Step title="1) Leer contratos base">Empieza por [API essentials](/docs/apis-events/api-essentials).</Step>
  <Step title="2) Definir semántica de eventos">Aplica [Convenciones de eventos](/docs/apis-events/event-conventions).</Step>
  <Step title="3) Cerrar seguridad de ejecución">Valida [Autenticación e idempotencia](/docs/apis-events/authentication-idempotency).</Step>
  <Step title="4) Formalizar racional arquitectural">Documenta trade-offs en [Arquitectura webhook-first](/docs/apis-events/webhook-first-architecture).</Step>
</Steps>

## Criterios de calidad de integración

| Criterio | Objetivo operacional |
| --- | --- |
| Procesamiento duplicado | 0 efectos laterales duplicados |
| Éxito de reintentos | 100% con backoff acotado |
| Eventos sin schema | 0 en producción |
| Errores 5xx persistentes | Sin backlog fuera de la ventana SLO |