> 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.

# Sua primeira integração

## Prepare o acesso

Peça a um administrador autorizado um token da API do Órbita e o UUID da organização. Confirme também a origem HTTP em que o gateway expõe o backend público.

Neste guia, `ORBITA_API_ORIGIN` representa essa origem, sem `/api/public/v1` no final. Ela precisa responder JSON na rota pública. O domínio da interface ainda exige ajuste de roteamento para essa finalidade.

## Configure o processo servidor

```bash
export ORBITA_API_ORIGIN='https://api.example.invalid'
export ORBITA_ORGANIZATION_ID='UUID_DA_ORGANIZACAO'
# Injete ORBITA_API_KEY pelo gerenciador de segredos do seu ambiente.
```

O domínio `.invalid` é ilustrativo: substitua pela origem confirmada do seu ambiente. Mantenha o token no servidor da integração.

## Liste os projetos

```bash
curl --fail-with-body   "$ORBITA_API_ORIGIN/api/public/v1/organizations/$ORBITA_ORGANIZATION_ID/projects?page=1&pageSize=20"   --header "X-Api-Key: $ORBITA_API_KEY"   --header 'Accept: application/json'
```

A resposta contém `items`, `total`, `page` e `pageSize`. Use o `id` do projeto para consultar suas issues. A chave visível de uma issue, como `ORB-42`, não substitui o UUID exigido em uma rota com `{id}`.

Se a resposta for HTML, revise o gateway antes de investigar o token. Se receber `401`, confira validade e revogação da credencial. Continue em [paginação e filtros](https://developers.orbita.nexxo.tec.br/api/paginacao-e-filtros.md).
