Versionado de aplicaciones

Publica un cambio de configuración de toda la aplicación como una versión revisable en lugar de editar en el sitio un cliente en producción. Envías una instantánea completa de la configuración —nombre, URI de redirección, ámbitos y eventos de webhook declarados— junto con un registro de cambios y una justificación; el cliente en producción sigue sirviendo su configuración actual hasta que un moderador la apruebe. Al aprobarse, la instantánea se aplica de forma atómica.

• Envía una versión nueva con una instantánea de configuración actualizada, un registro de cambios y una justificación.
• La aplicación en producción sigue ejecutando su configuración actual mientras la versión está pending de revisión: la aprobación es lo que la promueve a producción.
• Como máximo existe una versión abierta (draft / pending) por aplicación a la vez.
• Una instantánea puede llevar ámbitos de autoservicio y con revisión (account:read, a2a, recipe:express); el revisor es quien concede los de revisión, en el momento de la aprobación, exactamente igual que en una solicitud por ámbito. Los ámbitos con aprobación del equipo, como node:manage, se descartan de la instantánea.

Endpoints

Los endpoints del propietario se autentican por sesión (portal de desarrolladores). Los endpoints de revisión requieren un moderador.

Las formas completas de petición y respuesta están en la especificación OpenAPI bajo la etiqueta App versions: OpenAPI 3.1 (JSON) · YAML.

• Consulta Registro de aplicaciones para la vía de edición en el sitio y Visión general de la API para la superficie completa de endpoints.