API Authentication (TMS)

大多数 API 调用需要经过身份验证的用户。API 不使用任何特殊的个人资料。每个 API 都可以代表任何现有的用户，通过用户名和密码进行调用。

有两种方法可以与API进行身份验证：

在调用任何需要经过身份验证的用户的 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.。

示例：

ApiToken OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi

在应用程序中使用 OAuth 2.0，而不是在每次调用时发送令牌。Phrase TMS 支持标准 OAuth 2.0 授权代码授权类型。

要建立 OAuth 2.0 连接，请按照以下步骤操作：

在设置页面，向下滚动到集成部分，然后点击注册的 OAuth 应用。

注册的 OAuth 应用页面打开。
单击新建。

创建 OAuth 应用页面打开。
提供一个名称，重定向 URI（回调）和一个可选的描述。
点击保存。

注册的 OAuth 应用页面打开，列表中出现新的连接，并附带相关的客户 ID。

该 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 令牌的示例用法：

Bearer OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi