文档
测试

经销商同步接口

POST
测试:http://mobil-dms2.gz.hui-jia.com.cn/api/web/index.php?r=distributor 生产:https://campaign.mobil.com.cn/distributorlocator/api/web/index.php?r=distributor

接口描述

经销商同步接口,请求和响应格式为applicaiton-json

请求参数

参数名
类型
描述
必填
timeStamp
long
秒级时间戳
必填
sign
string
签名,长度32位MD5加密串,不区分大小写
必填
stripesCustomer
string
代码 (必填),这个为唯一性,通过该字段区分新增或编辑
必填
distributorName
string
经销商名称(中文) (必填)
必填
longtitude
double
经度
必填
lattitude
double
纬度
必填
address
string
地址
必填
city
string
城市
必填
province
string
省份
必填
phone
string
联系电话
必填
website
string
网站地址
必填
p
string
乘用车,传参固定值为 P,没有传空字符串
必填
c
string
商用车,传参固定值为 C,没有传空字符串
必填
i
string
工业用油,传参固定值为 I,没有传空字符串
必填
m
string
船舶,传参固定值为 M,没有传空字符串
必填
mobile
string
手机号
必填
pAobe
string
乘用车-aobe
必填
cAobe
string
商用车-aobe
必填
iAobe
string
工业用油-aobe
必填
mAobe
string
船舶-aobe
必填
pkOrg
唯一编码,必填
必填

响应参数

参数名
类型
描述
必填
code
int
响应编码,1成功,10签名错误,其他值失败
必填
message
string
响应提示信息
必填
success
boolean
true成功,false失败
必填
data
object
响应数据集
必填

说明 / 示例

以上参数若没有值的均传空字符串 参数签名说明 1. 参数名的字母序升序排序,以key1=value1&key2=value2的形式拼接待签名字符串,**sign参数和值为空的参数移除,不参与签名**。 例如参数: address=秀&c=C&city=广州&distributorName=kyle名字&i=I&lattitude=22&longtitude=11&m=M&mAobe=3&mobile=12211111111&p=P&phone=02012345678&province=广东&stripesCustomer=kyle&timeStamp=1623303466 2. 将签名KEY,用&拼接到最后面(KEY:40b0e50d048edd977fa3627669e850mh)【真实KEY问对接人】。 例如:address=秀&c=C&city=广州&distributorName=kyle名字&i=I&lattitude=22&longtitude=11&m=M&mAobe=3&mobile=12211111111&p=P&phone=02012345678&province=广东&stripesCustomer=kyle&timeStamp=1623303466&f73d0851aff74322bcecc0aea2bc2958 3. 通过md5算法签名。 例如步骤2签名后得到sign值是:5eb2368982860d139c085e668337bc23 4. 把sign值赋给接口sign参数。 ```php // 请求参数 ![WechatIMG1141.png](https://cos.easydoc.net/50089621/files/kpqnwvyq.png) // 响应参数 { "code": 1, "data": { "sign": "0fdead1bbcc53f17597b3e8896fc611b", "timeStamp": "1586481674389", "stripesCustomer": "1", "distributorName": "测试经销商", "aobe": "AOBE", "longtitude": "115.222244", "lattitude": "31.222244", "address": "天河区xx路xx号", "city": "广州市", "province": "广东省", "phone": "13530000000", "website": "http://www.baidu.com", "p": "P", "c": "C", "i": "I", "m": "M" }, "success": true, "message": "成功" } ```