La mayoría de las llamadas API requieren un usuario autenticado. Las API no usan ningún perfil de usuario especial. Cada API se puede llamar en nombre de cualquier usuario existente utilizando su nombre de usuario y contraseña.
Hay dos métodos para autenticarse con la API:
-
Autenticación basada en identificador único (token)
-
Autenticación OAuth 2.0
Autenticación basada en identificador único (token)
Antes de llamar a cualquier API que requiera un usuario autenticado, llame a la API de autenticación/inicio de sesión para obtener un identificador único (token) de autenticación. El identificador único (token) es válido durante 24 horas y se puede utilizar para todas las llamadas posteriores, pero caducará si el usuario cierra la sesión a través de la interfaz de usuario. No crear un identificador único (token) nuevo para cada llamada.
Los miembros de varias organizaciones del TMS tienen el mismo nombre de usuario y contraseña para varias cuentas. Si se utilizan varias cuentas, debe añadirse el userUid al órgano solicitante para especificar a qué organización desea acceder el usuario. Si no se especifica, el usuario inicia sesión en la cuenta predeterminada asociada con el nombre de usuario y la contraseña dados.
En llamadas API posteriores, el identificador único (token) obtenido se utiliza en el encabezado de la autorización. El campo del valor del encabezado se introduce con ApiToken seguido de un espacio y el identificador único (token).
Si un usuario cierra la sesión en la IU, el identificador único (token) API ya no será válido.
Si un perfil se encuentra en el DataCenter de los Estados Unidos, agregue nosotros antes de cloud.memsource.com, por ejemplo https:/us.cloud.memsource.com/web/api2/v3/auth/login.
Ejemplo:
Autenticación de OAuth 2.0
Usa OAuth 2.0 en las aplicaciones en lugar de enviar identificadores únicos (tokens) con cada llamada. Phrase TMS admite un tipo de concesión de código de autorización OAuth 2.0 estándar.
Para establecer la conexión OAuth 2.0, sigue estos pasos:
-
Desde la página
de configuración , ve hasta la sección y haz clic en Aplicaciones OAuth registradas.
Se abre la página .
-
Haz clic en Nuevo.
Se abre la página .
-
Proporciona un , (Devolución de llamada) y una opcional.
-
Haz clic en Guardar.
Se abre la página con la nueva conexión de la lista y un asociado.
El ID se utiliza en la aplicación que se conecta a phrase para establecer la conexión. Se almacena en la base de datos y se utiliza para emparejar solicitudes con el solicitante adecuado.
-
Use estas URL con el ID de cliente generado para autorización:
-
URL de Auth
https://cloud.memsource.com/web/oauth/authorize
-
Token URL
https://cloud.memsource.com/web/oauth/token
Si un perfil se encuentra en el DataCenter de los Estados Unidos, agregue nosotros antes de cloud.memsource.com, por ejemplo https://us.cloud.memsource.com/web/oauth/authorize
-
-
Al autorizar, usa el perfil de administrador para iniciar sesión y haz clic en Permitir.
Ahora la aplicación está vinculada y no se requerirá la llamada API autenticación.
Una vez establecida la conexión OAuth 2.0, se genera un identificador único (token) portador para usar en la aplicación.
Ejemplo de uso del identificador único (token):