跳转到主要内容

Postman 集合

每个合约均附带一个预配置了沙箱 URL 和示例请求体的 Postman 集合。导入集合、填入您的凭证，即可无需编写代码调用每个端点。

各合约集合​

合约集合备注
认证下载下载以下文件，将其导入 Postman，并替换参数 "service_account"、"tenant_id" 和 "secret_key" 的值以测试请求。
Web & SDK下载包含流程创建、GET 流程、GET 证据和 GET PDF。
API下载包含流程创建（POST）和 GET 流程。

设置​

  1. 下载集合，选择您要集成的合约对应的集合。
  2. 导入 Postman：File > Import > Upload Files。
  3. 根据集合配置凭证：

认证 — 打开集合，切换到 Variables 标签页，填入以下内容：

变量值
service_account您的服务账户名称。
tenant_id您的租户 ID。
secret_key您的私钥（PEM 格式）。
base_pathToken 端点主机。默认为 UAT（https://identityhomolog.acesso.io）；生产环境请改为 https://identity.acesso.io。

Web & SDK — 打开每个请求，将 Authorization: Bearer 的值替换为您自己的访问令牌。

API — 打开每个请求，将 Authorization: Bearer 和 APIKEY 请求头的值替换为您自己的凭证。

  1. 运行认证请求 — 预请求脚本会自动构建 JWT 断言并将其存储在 {{jwt_token}} 中。

预请求脚本​

只有认证集合包含预请求脚本。该脚本：

  • 从集合变量中读取 service_account、tenant_id、secret_key 和 base_path。
  • 使用内置的 KJUR 库构建并签署 JWT 断言（RS256）。
  • 将签署后的 token 保存在 {{jwt_token}} 中，并自动注入请求体。

Web & SDK 和 API 集合不含预请求脚本——凭证直接在请求头中设置。

下一步​

最后更新 于