外观
接入准备
约 344 字小于 1 分钟
指南快速开始
2026-10-19
在开始编码之前,需先了解接口调用时的一些注意事项:
appId、privateKey在接入之前向我司申请获取,私钥不可泄漏。- 请求方式:
POST,Content-Type: application/json。 - 贵司请求我司时,对
body按 签名规则 做 RSA 签名。 - 我司返回业务数据、以及回调贵司时,对业务数据做 RSA + AES 加密。贵司用私钥解密。
timestamp为北京时间,格式yyyy-MM-dd HH:mm:ss,请勿与当前时间间隔十分钟以上。
接口域名
接口路径拼接在对应环境域名之后。例如权益下发:{域名}/equity/common/send。
| 环境 | 域名 | 出口 IP | 入口 IP |
|---|---|---|---|
| 测试 | https://gw-test.senins.cn/omni-open/api | 101.201.56.169 | 8.141.29.0、8.152.156.197 |
| 预发 | https://gw-gray.senins.cn/omni-open/api | 101.201.56.169 | 8.141.29.0、8.152.156.197 |
| 生产 | https://gw.senins.cn/omni-open/api | 101.201.56.169 | 8.141.29.0、8.152.156.197 |
贵司如果有白名单拦截,请将出口 IP 101.201.56.169 加入网络白名单。
公共参数
| 参数名称 | 参数说明 | 是否必须 | 数据类型 | 说明 |
|---|---|---|---|---|
| appId | 系统标识 | true | string | 我司分配 |
| body | 业务数据 | true | object | 具体业务参数,参与签名 |
| sign | 签名 | true | string | 对 body 按签名规则计算 |
| asyncNotify | 是否异步 | true | boolean | 建议传 true,开通结果以结果通知为准 |