大多数 API 调用都需要经过身份验证的用户。API 不使用任何特殊的用户个人资料。每个 API 都可以代表任何现有用户使用其用户名和密码进行调用。
有两种方法可以对 API 进行身份验证：
-
基于令牌的身份验证
-
OAuth 2.0 身份验证
基于令牌的身份验证
在调用任何需要经过身份验证用户的 API 之前，请调用 auth/login API 以获取身份验证令牌。令牌有效期为 24 小时，可用于所有后续调用，但如果用户通过 UI 注销，令牌将会过期。请勿为每次调用创建新令牌。
多个 TMS 公司的成员对多个账户使用相同的用户名和密码。如果使用多个账户，必须将 userUid 添加到请求正文中，以指定用户想要登录的公司。如果未指定，用户将登录到与给定用户名和密码关联的默认账户。
在后续 API 调用中，获取的令牌将用于 Authorization 标头。标头值字段以 ApiToken 开头，后跟一个空格和令牌本身。
如果用户从 UI 注销，API 令牌将不再有效。
如果个人资料位于美国数据中心，请在 cloud.memsource.com 前添加 us.，例如 https://us.cloud.memsource.com/web/api2/v3/auth/login.
示例：
OAuth 2.0 身份验证
在应用程序中使用 OAuth 2.0，而不是在每次调用时发送令牌。Phrase TMS 支持标准的 OAuth 2.0 授权码授予类型。此 OAuth 2.0 流程是一种仅通过重定向 URI 验证的公共客户授权码授予，不支持客户密钥和 PKCE (code_challenge)。在继续之前，请确认第三方工具仅使用客户 ID 和重定向 URI 即可运行。
注释
属于多个公司的用户账户不支持 OAuth 登录。
请从其中一家公司中移除该用户账户，使其仅属于一家公司，或者改用基于令牌的身份验证。
要建立 OAuth 2.0 连接，请按照以下步骤操作：
-
从设置
页面，向下滚动到部分，然后点击已注册 OAuth 应用。
页面打开。
-
单击新建。
页面打开。
-
提供、（回调）以及可选的。
-
点击保存。
页面打开，列表中包含新连接以及关联的。
该 ID 用于连接到 Phrase 的应用程序中，以建立连接。它存储在数据库中，用于将请求与正确的请求者配对。
-
将这些 URL 与生成的客户 ID 一起用于身份验证：
-
身份验证 URL
https://cloud.memsource.com/web/oauth/authorize
-
令牌 URL
https://cloud.memsource.com/web/oauth/token
如果个人资料位于美国数据中心，请在 cloud.memsource.com 之前添加 us.，例如 https://us.cloud.memsource.com/web/oauth/authorize。
-
-
授权时，使用管理员个人资料登录并点击允许。
应用程序现已关联，无需进行身份验证 API 调用。
一旦建立 OAuth 2.0 连接，就会生成一个用于应用程序的 Bearer 令牌。
Bearer 令牌的使用示例：