> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# Escolha sua superfície

## Contratos e credenciais

| Superfície       | Caminho no backend                     | Autenticação                 | Uso                                                                    |
| ---------------- | -------------------------------------- | ---------------------------- | ---------------------------------------------------------------------- |
| 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ário               | Interface, operações operacionais e administração autorizada.          |
| Webhooks         | POST do Órbita ao seu receptor         | HMAC-SHA256                  | Receber eventos de domínio.                                            |
| MCP              | Endpoint `/mcp` do servidor MCP        | OAuth e JWT de usuário       | Ferramentas 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](https://developers.orbita.nexxo.tec.br/operacao/enderecos-e-disponibilidade.md).
