在 Workiva 中,生成访问令牌(具体来说是 OAuth2 持有者令牌)是一个两步过程:首先创建 API 授权以获取凭据,然后使用这些凭据请求实际令牌。
1. 创建 API 授权
重要提示: 您必须是工作区所有者才能执行此步骤。
获取客户端 ID 和密钥:
- 点击 Workiva 页面右上角的 ID 图标,然后选择 “工作区设置”。
- 选择 “安全” 选项卡,然后单击 “创建 API 授权”。
- 在 “更新拨款” 页面上,填写以下字段:
- 输入 客户名称 和该资助将代表其执行操作 的 Workiva 用户名 。
- 选择“OAuth2 客户端凭据”作为 客户端类型。
- 选择您计划使用的 API 端点所需的 范围 (权限)。
- 设置 到期 日期。
- 除非贵组织有明确要求,否则您可以忽略 IP 允许列表 字段。
- 点击 “添加授权”。
重要提示: 请立即复制客户端 ID 和客户端密钥,因为密钥将不会再次显示。
2. 获取 Bearer Token
获得凭证后,您必须通过向 Workiva IAM 服务发出 POST 请求,将其交换为短期访问令牌。
- 端点:
https://api.app.wdesk.com(这是美国的默认端点; 其他地区有不同的端点)。 - 内容类型: 将
Content-Type设置为application/json。 - 标头:添加
X-Version:2026-01-01 - 表单值:
-
grant_type: 客户端凭证 -
client_id:[Your Client ID] -
client_secret:[Your Client Secret] -
范围:链条
-
- 有效期: Workiva 持有者代币通常有效期为 10 分钟。对于长时间运行的进程,必须定期刷新它们。
SEC EDGAR Next Tokens
如果您 专门为向美国证券交易委员会 (SEC) 提交文件(EDGAR Next)而生成代币,那么这些代币与标准 API 代币有所不同:
- 这些令牌(申报者 API 令牌和用户令牌)是在美国证券交易委员会的 EDGAR 申报者管理仪表板上创建的。
- 获得代币后,您可以在 Workiva 的 SEC 报告 > 管理 EDGAR Next 代币中进行管理。