Open API / 接入准备
接入准备
所有接口共用同一套应用身份。做完本页即可调用左侧任一 API。
- 开放平台分配
AppID(默认ys_app_asset)。 - 开放平台生成 RSA 2048 密钥对:公钥入库验签,私钥由对接人员线下交给调用方。
- 调用方把收到的私钥放在己方服务端,请求头带
X-YS-App-Id与X-YS-Key-Version(当前v1)。 - 如需 IP 限制,报备出口 IP / CIDR;未配置则不限制。
| 材料 | 生成方 | 保管方 | 用途 |
|---|---|---|---|
RSA 私钥 | 开放平台 | 调用方服务端(线下交付后自行保管) | 计算 X-YS-Signature |
RSA 公钥 PEM | 开放平台 | 开放平台 | 验签。调用方发请求时不用带公钥 |
AppID | 开放平台分配 | 双方配置一致 | 请求头 X-YS-App-Id |
Key-Version | 开放平台登记,当前 v1 | 双方配置一致 | 请求头 X-YS-Key-Version |
平台生成密钥对,调用方只用收到的私钥签名。不要自己另造一对再来备案公钥。