交互约定
通信方式
首汽约车和供应商使用json over https方式通信, json数据需要AES加密后放在body中同时ContentType保持不变,具体相约如下:
- http method: post
- content-type: application/json
- charset: utf-8
- 自定义header:
channe: 首约侧分配给对接渠道的渠道号
timestamp: 请求时间戳,生产环境只允许与服务器时间差值在1分钟内的请求
sign: 按一定规则生成的签名字符串
- body: 业务请求参数封装为json格式后使用对称加密得到的字符串,请求格式仍按application/json,
- response: 接口响应,详见BusResponseDTO
{
"code": 1000,
"msg": "success",
"data": null
}
备注:channel 由首汽约车提供,用以标识具体供应商,timestamp为精确到毫秒的当前时间戳,sign为验签字段,验签和DES加密分别使用的signKey和secret由首汽约车提供。
首汽约车巴士服务域名
测试环境: https://test-openapi-bus.01zhuanche.com 生产环境: https://openapi-bus.01zhuanche.com
返回结果统一约定
参数名称 | 类型 | 是否必选 | 说明 |
---|---|---|---|
code | int | 是 | 服务响应状态码,详见返回码说明 |
msg | string | 是 | 服务响应状态说明,详见返回码说明 |
data | object | 是 | 详细数据 |
说明: 返回的数据中与费用相关的字段均是字符串表示,按四舍五入保留了两位有效数字。