至尊用车加盟门店API文档V1.0.docVIP

至尊用车加盟门店API 1.0 模块名称 至尊用车加盟门店 所属系统 租车 模块负责人 刘俊 项目负责人 刘俊 文档提交日期 2014/11/11 修改记录 No 修改后 版本号 修改内容简介 修改日期 修改人 1 V 全文 2014/11/11 刘俊 概述 业务流程 请求方式 接口均采用HTTP，请求方式POST。 字符编码 使用UTF-8编码，除非特别声明。 API前缀 每个API的前缀缺省为： http://$DOMAIN/ 其中，$DOMAIN应替换为实际域名地址（如）。当使用下文所定义的API时，需在API之前补齐此前缀。 环境地址 开发环境：http://JoinS 线上环境：http:// JoinS API调用方法 参数介绍 API的输入参数包含系统级参数和应用级参数。 系统级参数：对于每个API均一致，用于加密、标识用户身份、API协议版本等用途。 名称 是否必选 含义 类型 取值示例及说明 reqId 是 每次调用的请求号 String 不能重复 sign 是 API输入参数签名结果 String 应用级参数：针对API的不同用途，应用级参数各不相同，详细参见API文档。 名称 是否必选 含义 类型 取值示例及说明 joinStoreEncrypt 是 加盟商密串 String 签名方法 调用API时，需要将所有参数名称以及参数值加入签名，即：系统级参数（除去sign）名称、系统级参数值、应用级参数名称、应用级参数值全部加入签名。 I．签名参数串排序 签名时，根据参数名称，将除签名（sign）外所有请求参数按照字母先后顺序排序: key + value .... key + value 。 注： 1、排序若首字母相同，则对第二个字母进行排序，以此类推。 2、value无需编码。 3、对于非必选参数，如果没有value值，也可不参与签名。（说明：非必选参数没有value值时，将参数名放到字符串中，即参数名要参加签名） 例如：将“foo=1,bar=2,baz=三”排序为“bar=2,baz=三,foo=1”参数名和参数值链接后，得到拼装字符串bar2baz三foo1。 II．签名算法 API会分配一个接口调用的secret， 将分配的得到的secret同时拼接到参数字符串头、尾部进行md5加密，再转化成大写，格式是：md5(secretkey1value1key2value2...secret)。 至尊提供API 同步车辆行程 描述 同步车辆行程 URI sync/syncVoitureCalendar 请求方法 POST 表单参数 名称 是否必选 含义 类型 取值示例及说明 shopSign 是 车牌 String orderId 是 订单ID Int beginTime 是 开始时间 Datetime endTime 是 结束时间 Datetime rentStoreName 是 租车门店名称 String returnStoreName 是 还车门店名称 String status 是 状态 Int 1.新增/更新 0.删除 返回值 返回值字段 类型 说明 IsSuccess Bool 返回代码，成功，其为错误 Msg String 返回信息 返回值示例（JSON） {IsSuccess:true,Msg:} 同步车辆资料 描述 同步车辆资料 URI sync/syncVoiture 请求方法 POST 表单参数 名称 是否必选 含义 类型 取值示例及说明 shopSign 是 车牌 String carModel 是 车型ID Int storeId 是 所有门店ID String 返回值 返回值字段 类型 说明 IsSuccess Bool 返回代码，成功，其为错误 Msg String 返回信息 VoitureID 至尊车辆ID String 返回值示例（JSON） 同步门店资料 描述 同步门店 URI sync/syncStore 请求方法 POST 表单参数 名称 是否必选 含义 类型 取值示例及说明 storeName 是 车牌 String beginTime