---
title: Postman 集合
description: 适用于认证、Web & SDK 和 API 合约的即用型 Postman 集合。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/api-reference/postman
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- [API 参考](/zh-CN/dual-api/developers/api-reference/)
- Postman 集合

**本页内容# Postman 集合

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

合约集合备注**认证**[下载](/postman/oauth2.postman_collection.json)下载以下文件，将其导入 Postman，并替换参数 "service_account"、"tenant_id" 和 "secret_key" 的值以测试请求。**Web & SDK**[下载](/postman/web-sdk-integration.postman_collection.json)包含流程创建、GET 流程、GET 证据和 GET PDF。**API**[下载](/postman/api-integration.postman_collection.json)包含流程创建（POST）和 GET 流程。
### 设置​

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

**认证** — 打开集合，切换到 Variables 标签页，填入以下内容：
变量值`service_account`您的服务账户名称。`tenant_id`您的租户 ID。`secret_key`您的私钥（PEM 格式）。`base_path`Token 端点主机。默认为 UAT（`https://identityhomolog.acesso.io`）；生产环境请改为 `https://identity.acesso.io`。
**Web & SDK** — 打开每个请求，将 `Authorization: Bearer` 的值替换为您自己的访问令牌。
**API** — 打开每个请求，将 `Authorization: Bearer` 和 `APIKEY` 请求头的值替换为您自己的凭证。

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

### 预请求脚本​

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

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

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

[认证](/zh-CN/dual-api/developers/api-reference/authentication) — 生成集合所需的凭证。
[Web & SDK 概述](/zh-CN/dual-api/developers/api-reference/web-sdk) — Web & SDK 集合的背景信息。
[API 概述](/zh-CN/dual-api/developers/api-reference/api) — API 集合的背景信息。
最后更新 于 2026年10月8日**