OpenAPI
Como o portal consome e valida o contrato OpenAPI 3.1.
O arquivo publicado em /openapi.yml é uma cópia sincronizada de source-docs/openapi.yml, versionado neste repositório. Ele é validado com Redocly antes do build e alimenta a referência própria da CodeChat, a busca global e o resumo de operações.
Separação visível
- Operações atuais usam as tags funcionais
Instances,Connections,Messages,Message Batches,Chats,Media,GroupseWebhooks. - Os 14 eventos globais de lote aparecem no objeto
webhooksdo OpenAPI 3.1, com headers, envelopes e exemplos próprios. - As operações Pro, incluindo as nove rotas de Message Batches, usam
x-codechat-plan: proex-codechat-plan-enforced: false. - Aliases antigos ficam em tags
Legacy - …;deprecated: trueaparece somente quando existe substituto atual equivalente.
Não edite a cópia em public/openapi.yml manualmente. Altere source-docs/openapi.yml e execute pnpm sync:docs no portal.
