每个已配置的知行之桥用户都可以有一个用来访问管理系统 API 的身份认证令牌。更多的关于用户和角色的信息，可以参考 用户和角色管理。

使用身份认证令牌

可以通过多种方式在API请求中使用身份认证令牌：

• 在 HTTP 请求中包含 x-cdata-authtoken 头部，并设置为当前用户的身份认证令牌
• 将用户／身份认证令牌当做 HTTP 基本身份认证的用户名／密码
• 在请求URL中将身份认证令牌作为查询参数

此示例使用身份验证令牌消息头 (x-cdata-authtoken) 作为身份验证方法。 要使用该方法：

1. 单击知行之桥导航栏上的 系统设置 图标。 然后单击添加打开添加用户对话框或编辑现有用户。

2. 在出现的对话框中，选中复选框 API 访问 以显示身份验证令牌。 （将此令牌复制到安全位置，因为该对话框将不会再次显示。如果你丢失或删除了你的身份验证令牌，则必须创建一个新令牌。）单击 保存更改。

要在请求 URL 中使用身份认证令牌，步骤如下：

1. 打开系统设置。

2. 选择系统 API 选项卡。

3. 在 其它 一节中启用 AllowAuthTokenInURL 设置。

身份认证令牌查询参数的语法如：’@authtoken=myAuthTokenValue’。