公共规范
数据交互规范
| 项目 | 说明 |
|---|---|
| 交互协议 | https + json |
| 交互方式 | post + utf-8 |
| 请求参数 | 加密验签 |
| 响应参数 | 加密验签 |
| 请求 URL | 渠道地址 + 接口 Path |
公共入参
| 名称 | 类型 | 是否必须 | 备注 | 其他信息 |
|---|---|---|---|---|
| sign | string | 必须 | 签名 | |
| key | string | 必须 | RSA 加密后的 AES KEY | |
| paramData | string | 必须 | 密文数据 | |
| channelCode | string | 必须 | 分配的渠道号 | 我方调用渠道方填写渠道方渠道号,渠道方回调用我方填写我方渠道号 |
| timestamp | string | 必须 | 请求时间戳(13 位) |
公共返参
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| errorCode | integer | 必须 | 接口层面响应状态码,1 成功 |
| message | string | 必须 | 响应描述 |
| key | string | 必须 | RSA 加密后的 AES KEY |
| paramData | string | 必须 | 密文业务数据 |
| sign | string | 必须 | 签名 |
响应码
| 类型 | code | msg | 描述 |
|---|---|---|---|
| 公共 | 1 | 请求成功 | 返回码成功 |
| 公共 | -1 | 渠道不存在 | 渠道不存在 |
| 公共 | -2 | 参数错误 | 参数校验未通过 |
| 公共 | -3 | 验签失败 | 签名验证失败 |
| 公共 | -4 | 解密失败 | 参数解密失败 |
| 公共 | -9999 | 系统异常 | 系统未知异常 |
| 业务 | 1 | 请求成功 | 返回码成功 |
| 业务 | -1 | 业务处理异常 | 例如请求业务参数缺失、用户信息不存在或其他业务异常 |
待确认:源文档未说明具体加密算法参数、签名拼接规则、密钥交换流程和加解密工具类下载地址。