Versionamento de aplicativos
Entregue uma mudança de configuração de todo o aplicativo como uma versão revisável em vez de editar um cliente em produção no lugar. Você envia um snapshot completo de configuração — nome, URIs de redirecionamento, escopos e eventos de webhook declarados — com um changelog e uma justificativa; o cliente em produção continua servindo sua configuração atual até que um moderador aprove. Na aprovação, o snapshot é aplicado atomicamente.
- Envie uma nova versão com um snapshot de configuração atualizado, um changelog e uma justificativa.
- O aplicativo em produção continua rodando sua configuração atual enquanto a versão
está
pendingde revisão — a aprovação é o que a promove para produção. - Existe no máximo uma versão aberta (
draft/pending) por aplicativo de cada vez. - Um snapshot pode carregar escopos de autosserviço e com análise (
account:read,a2a,recipe:express); o revisor é quem concede os com análise, no momento da aprovação, exatamente como em uma solicitação por escopo. Escopos com aprovação da equipe, comonode:manage, são descartados do snapshot.
Endpoints
Os endpoints do proprietário são autenticados por sessão (portal do desenvolvedor). Os endpoints de revisão exigem um moderador.
| Método | Caminho | Observações |
|---|---|---|
| POST | /developer/clients/{clientId}/versions | Envie uma nova versão — { config, changelog, justification }; limite de taxa de 20/hora |
| GET | /developer/clients/{clientId}/versions | Liste as versões do aplicativo, as mais recentes primeiro |
| GET | /admin/oauth/client-versions | Moderador: fila de revisão · ?status=pending|approved|rejected|all ?limit |
| PATCH | /admin/oauth/client-versions/{id} | Moderador: { decision: approved|rejected, reject_reason? } — aprovar aplica o snapshot |
As formas completas de requisição/resposta estão na especificação OpenAPI sob a tag App versions: OpenAPI 3.1 (JSON) · YAML.
- Veja Registro de aplicativos para o caminho de edição no lugar e Visão geral da API para a superfície completa de endpoints.