销售数据接口文档.docxVIP

销售数据对接技术中心API文档_2.0 1.1概述 测试地址:/ 线上地址:/ 1.2接口约定 接口基于 API方式通过HTTP方式进行调用； 返回格式：JSON； 验证方式：MD5签名验证 请求参数体以post方式提交,json 数据格式返回； 1.2.1公共传入接口参数: 参数 必选 类型 说明 timestamp ture int 当前时间戳[默认180秒有效] sign true string 生成签名 code true string 固定字符 ‘kechuan’ 1.2.2公共返回参数: 参数 必选 类型 说明 time ture int 时间戳 code true int 200业务处理成功,其他失败 msg true string 失败原因如:签名错误 data true string 成功返回数据 1.2.3签名规则:md5签名 1:除去数组中的空值和签名参数 2:对数组排序(按照键名对关联数组进行升序排序) 3:把数组所有元素，按照“参数=参数值”的模式用“&”字符拼接成字符串,去掉最后一个&字符 4:如果存在转义字符，那么去掉转义 5:把所得字符串与key(key由dd01提供)拼接 6:MD5两次最后字符串 签名实例: function makeSign($mkey, $para) { ??//除去数组中的空值和签名参数 $para_filter = array(); foreach ($para as $key => $val) { ??if ($key == "sign" || $val == "") continue; ??else ???$para_filter[$key] = $para[$key]; } //对数组排序 ksort($para_filter); // 把数组所有元素，按照“参数=参数值”的模式用“&”字符拼接成字符串 $arg = ""; foreach ($para_filter as $key => $val) { ??$arg .= $key . "=" . $val . "&"; } //去掉最后一个&字符 $arg = rtrim($arg, "&"); //如果存在转义字符，那么去掉转义 $arg ???= stripslashes($arg); $prestr = $arg . '&key=' . $mkey; $sign ??= md5(md5($prestr)); } 1.3接口列表 1.3.1 基础付款方式 接口地址：api/merchant/payTypeList 请求方法：POST 请求参数： 参数 必选 类型 说明 contract_no false string 合同编号 (合同编号和项目编号都为空返回所有店铺信息) project_id false string 项目编号 返回参数: 参数 必选 类型 说明 contract_no true string 合同编号 pay_type_no true string 付款方式编码 pay_type_name true string 付款方式名称 is_pay_more true int 允许多付1是,0否 is_change true int 允许找零1是,0否 is_return true int 允许退货1是,0否 返回示例： { ???"code": 200, ???"msg": "", ???"time": "1554805005", ???"data": [ ???????{ ???????????"pay_list": { ???????????????"1": { ???????????????????"pay_type_name": "现金", ???????????????????"pay_type_no": 10001, ???????????????????"is_pay_more": 1, ???????????????????"is_change": 1, ???????????????????"is_return": 1 ???????????????}, ???????????????"2": { ???????????????????"pay_type_name": "微信", ???????????????????"pay_type_no": 10002, ???????????????????"is_pay_more": 1, ???????????????????"is_change": 1, ???????????????????"is_return": 1 ???????????????}, ???????????????"3": { ????????????