Contratos e credenciais

SuperfícieCaminho no backendAutenticaçãoUso
API pública/api/public/v1/organizations/{orgId}X-Api-Key com token wk_…Listar projetos e issues, consultar e criar issue, enviar solicitação.
API da aplicação/api/v1/organizations/{orgId}JWT de usuárioInterface, operações operacionais e administração autorizada.
WebhooksPOST do Órbita ao seu receptorHMAC-SHA256Receber eventos de domínio.
MCPEndpoint /mcp do servidor MCPOAuth e JWT de usuárioFerramentas autorizadas, conforme as condições do piloto.

Comece pela API pública

Um token de integração pertence à organização e pode acessar sua superfície pública sem participação humana em cada projeto. O contrato atual não oferece seleção de projetos ou scopes por token. Emita uma credencial para cada integração e proteja seu alcance organizacional.

A API pública não oferece todas as operações da aplicação. Atualizar estado, atribuir pessoas, editar comentários ou gerenciar membros não são operações do controller público atual.

Endereços e gateway

Os caminhos desta tabela são do backend. A aplicação usa o proxy /api/work para a API privada. O gateway de produção precisa expor separadamente a API pública; acrescentar /api/public ao host da interface não garante esse roteamento.

Veja endereços e disponibilidade.