Documentação da Pulsus Public Apps API

Bem-vindo à documentação da Pulsus Public Apps API, a API pública de Apps (compatível com Rails) exposta através do Kong Gateway. Aqui você encontra guias para começar a integrar rapidamente, além da referência completa de endpoints gerada automaticamente a partir da nossa especificação OpenAPI.

Por onde começar

1. Autenticação — gere um JWT via Keycloak antes de tudo.
2. Erros — como interpretar os códigos de erro.
3. Limites de uso — boas práticas de requisições.
4. Referência da API — os seis endpoints aprovados, seus parâmetros e schemas.

Escopo inicial de staging

Contrato 0.3.0: versões continuam lista, ativas por padrão; include_inactive=true inclui removidas. distribution_status informa current, contingency, test ou none. Não são expostos caminhos/checksum/URLs de artefatos nem flags internas Enterprise. Android Enterprise omite effective_version nas projeções de distribuição. Instalações trazem o último estado ainda instalado de aplicativos gerenciados; include_unmanaged=true permite inventário não gerenciado. distributions permanece independente e não prova instalação. Play Store aceita somente aplicativos já cadastrados/aprovados; limpeza de dados e aprovação de catálogo não fazem parte desta API. Mantenha os mesmos filtros ao usar cursor de 60s.

Esta primeira publicação é intencionalmente limitada às seis operações aprovadas abaixo:

1. listar aplicativos de um grupo;
2. listar aplicativos de até 100 grupos;
3. listar versões de um aplicativo;
4. listar instalações e distribuições desejadas de um aplicativo;
5. associar aplicativo a grupo;
6. remover aplicativo do grupo.

Upload, dispositivos, mutações de versão e outras capacidades fazem parte do roadmap futuro. Eles não aparecem nesta referência, no OpenAPI ou na collection Postman de staging e não estão disponíveis no serviço.

cuidado

Requisições marcadas como "apenas recursos de teste" alteram dados no Rails e devem ser usadas somente com recursos isolados de teste.

Ambientes

Ambiente	Gateway (API)	Keycloak (Auth)
Staging	https://eu.connect.pulsus.mobi	https://eu.auth.pulsus.mobi
Produção US	https://connect.pulsus.mobi	https://auth.pulsus.mobi
Produção Europa	https://eu.connect.pulsus.mobi	https://eu.auth.pulsus.mobi

Use credenciais e tenant da região correspondente; credenciais europeias não são intercambiáveis com US ou staging.

Precisa de ajuda?

Use o canal de suporte Pulsus da sua organização. Não compartilhe tokens ou secrets em chamados, prints ou collections públicas.