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

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

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.