| Regra | Detalhe |
|---|---|
| Protocolo | HTTPS em produção. JSON UTF-8 no corpo. |
| Versão | No path: /api/v1. Não no header. |
| IDs | id de recurso é UUID. |
| Timestamps | ISO-8601 UTC (2026-08-20T15:00:00.000Z). |
| Null | null explícito = sem valor. Omitir no PATCH = não mudar. |
| Chaves extras | Rejeitadas na escrita (additionalProperties: false). |
| Chaves desconhecidas na resposta | Ignore. Campos aditivos podem aparecer em /api/v1. |
| Métodos | GET lista/get, POST cria, PATCH atualiza. DELETE só em webhooks e em tags/participantes do inbox. |
GuiasConvenções
Convenções
HTTPS, JSON, /api/v1 no path, UUIDs, timestamps UTC.