La mayoría de las llamadas API requieren un usuario autenticado. Las API no usan ningún perfil de usuario especial. Cada API puede ser llamada en nombre de cualquier usuario existente utilizando su nombre de usuario y contraseña.
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.
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 interfaz de usuario, el identificador único (token) API ya no será válido.
Ejemplo:
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 con OAuth 2.0, siga estos pasos:
-
Desde la página Configuración
, desplácese hacia abajo hasta la sección y haga clic en Aplicaciones OAuth registradas.
Se abre la página de .
-
Haga clic en Nuevo.
Se abre la página .
-
Proporcione un , (devolución de llamada) y una opcional.
-
Haz clic en Guardar.
La página de se abre 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 obtener autorización:
-
URL Auth
https://cloud.memsource.com/web/oauth/authorize
-
Token URL
https://cloud.memsource.com/web/oauth/token
Si su perfil se encuentra en el DataCenter de los Estados Unidos, nos Agregará antes de cloud.memsource.com, por ejemplo https://us.cloud.memsource.com/web/oauth/authorize
-
-
Al autorizar, use el perfil de administrador para iniciar sesión y haga clic en Permitir.
Ahora la aplicación está vinculada y no será necesaria la llamada API autenticación.
Ejemplo de uso de identificador único (token) del portador: