1、协议说明
接入协议 | HTTP |
---|---|
编码格式 | UTF-8 |
接口地址 | http://jaxfapi.jjxsw.vip/api/v1 |
说明 | 1. 请先联系管理员,提供平台名称、联系人和联系电话,管理员分配账号,拿到accessKey和secretKey之后才能访问接口。 1. 分配好账号后,请先调通测试接口,没有问题之后,再进行其他接口的对接。 |
2、接口鉴权
参数名称 | 参数类型 | 说明 |
---|---|---|
accessKey | String | 平台对应账号的唯一标识 |
secretKey | String | 平台对应账号的密钥 |
timestamp | long | 时间戳,单位为毫秒 |
nonce | String | 随机数 |
sign | String | 通过生成规则生成的签名 |
注意
- 请务必严格保管好账号凭证,请勿将accessKey和secretKey泄露,以免造成数据丢失问题。
- sign的生成规则:
GET、DELETE请求:将鉴权参数按参数名顺序排序拼接,并用MD5进行一次加密 例如:MD5(“accessKey=v1&nonce=v2&secretKey=v3×tamp=v4”) POST、PUT请求:将鉴权参数和请求参数一起按参数名顺序排序拼接,并用MD5进行一次加密 例如:MD5(“accessKey=v1&id=1&nonce=v2&secretKey=v3×tamp=v4&value=测试”);
3、返回参数
参数 | 类型 | 说明 |
---|---|---|
code | int | 接口请求状态码 |
msg | String | 返回消息 |
data | JSON | 数据实体 |
errors | JSON | 请求参数不符合格式的错误提示 |