Operações
Todas recebem o prefixo /api/public/v1/organizations/{orgId} e exigem um token da organização.
Origem do contrato
Esta especificação foi transcrita do PublicApiController, dos DTOs e das validações do backend. O arquivo OpenAPI fica versionado com a documentação e gera as páginas desta referência. Ele cobre a superfície pública selecionada, e não a API privada inteira.
As rotas públicas retornam os DTOs do servidor. Campos opcionais e novos campos aditivos devem ser tolerados pelos consumidores. A origem .invalid nos exemplos é ilustrativa; leia endereços e disponibilidade antes de executar chamadas.
Erros e autenticação
Consulte autenticação, paginação e erros e limites. Nem toda resposta de erro usa o envelope do middleware de negócio.