交互约定

通信方式

首汽约车和供应商使用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 详细数据

说明: 返回的数据中与费用相关的字段均是字符串表示,按四舍五入保留了两位有效数字。

Copyright © 首约科技(北京)有限公司 2020 all right reserved,powered by Gitbook该文件修订时间: 2024-09-10 08:31:45

results matching ""

    No results matching ""