Una aplicación da a tu propio software acceso a la API de Softalon en https://api.softalon.com/v1. Cada aplicación tiene un Client ID y un Client Secret, que usa para obtener tokens de acceso con OAuth 2.0.
Hay dos tipos de aplicaciones:
Crear una aplicación del salón
Antes de empezar
- Tu salón tiene el plan Ultimate.
- Tienes el rol Super administrador o Propietario.
- 1
Paso 1 de 5
Abre Aplicaciones
Ve a Configuración › Desarrolladores › Aplicaciones y haz clic en Crear aplicación.
- 2
Paso 2 de 5
Ponle nombre a la aplicación
Introduce un Nombre de la aplicación. Las personas ven este nombre cuando se les pide que autoricen tu aplicación.
- 3
Paso 3 de 5
Añade permisos
En Permisos, añade uno a uno cada permiso (scope) que necesite tu aplicación. Tu aplicación solo puede solicitar los permisos que añadas aquí. Consulta la lista de permisos más abajo.
- 4
Paso 4 de 5
Añade URIs de redirección
En URIs de redirección, añade cada URL completa que use tu aplicación para recibir respuestas OAuth, por ejemplo
https://app.example.com/oauth/callback. Tu aplicación solo puede usar las URIs que añadas aquí. Puedes omitir este paso si tu aplicación solo se comunica con la API desde un servidor. - 5
Paso 5 de 5
Crea la aplicación y guarda el secreto
Haz clic en Crear aplicación.
Verás:Un cuadro de diálogo de credenciales con tu Client ID y tu Client Secret.
Copia los dos y guárdalos en un lugar seguro de inmediato.
El Client Secret se muestra una sola vez. Cuando cierras el cuadro de diálogo, la tabla muestra una versión enmascarada. Si pierdes el secreto, elimina la aplicación y crea una nueva.
Crear una aplicación de la cuenta
Ve a Cuenta › Aplicaciones y haz clic en Registrar aplicación. Los campos y el secreto de un solo uso funcionan igual que en una aplicación del salón.
Permisos
Los permisos tienen el formato area:action.
Añade solo los permisos que necesite tu aplicación.
Obtener tokens
Las aplicaciones admiten estos tipos de concesión (grant types) de OAuth 2.0:
- Client credentials, para el acceso de servidor a servidor sin usuario.
- Authorization code, cuando una persona inicia sesión y aprueba tu aplicación. Consulta Permitir que una aplicación acceda a tu cuenta.
- Refresh token, para obtener nuevos tokens de acceso sin volver a pedir permiso.
Cuando tu aplicación solicita un token, envía su Client ID y su secreto con autenticación HTTP Basic.
Editar o eliminar una aplicación
Abre el menú de la aplicación en la tabla:
- Actualizar cambia el nombre, los permisos o las URIs de redirección. El Client ID y el secreto no cambian.
- Eliminar borra la aplicación y sus credenciales. Ningún sistema que las use podrá volver a obtener tokens.
Preguntas frecuentes
No. Solo se muestra al crear la aplicación. Elimina la aplicación y crea una nueva para obtener un secreto nuevo.