1. 保存商户
用户通过web端或APP完善商户信息接口
JSON
POST
| 参数名称 | 约束 | 类型 | 长度 | 描述 | 取值说明 |
|---|---|---|---|---|---|
| app_id | 1 | String | 30 | 应用ID | Api服务分配 |
| transaction_id | 1 | String | 30 | 请求流水号 | 不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
| 父参数名称 | 参数名称 | 约束 | 类型 | 长度 | 描述 | 取值说明 |
|---|
|-|businessStore|object|-|-|商户基本节点|-|
|businessStore|userId|String|-|30|用户ID|-|
|businessStore|name|1|String|50|商户名称|-|
|businessStore|address|1|String|200|商户地址|-|
|businessStore|password|?|String|200|密码|MD5加密密码|
|businessStore|tel|1|String|11|联系电话|-|
|businessStore|storeTypeCd|1|String|10|店铺种类|详见表store_type定义|
|businessStore|nearbyLandmarks|1|String|200|地标|地标,如王府井北60米|
|businessStore|mapX|1|String|20|地区 x坐标|-|
|businessStore|mapY|1|String|20|地区 y坐标|-|
|-|businessStoreAttr|?|object|-|商户属性|-|
|businessStoreAttr|specCd|1|String|12|属性编码|商户服务提供|
|businessStoreAttr|value|1|String|50|属性值|-|
|-|businessStoreCerdentials|?|object|-|商户证件|-|
|businessStoreCerdentials|credentialsCd|1|String|12|证件类型|对应于 credentials表|
|businessStoreCerdentials|value|1|String|50|证件号码|-|
|businessStoreCerdentials|validityPeriod|1|String|-|有效期|格式为YYYY-MM-DD hh:mm:ss 例如:2018-07-07 11:04:00 如果是长期有效 写成 3000-01-01 00:00:00|
|businessStoreCerdentials|positivePhoto|1|String|100|正面照片|照片存储大数据中路径|
|businessStoreCerdentials|negativePhoto|1|String|100|反面照片|照片存储大数据中路径|
当http返回状态不为200 时请求处理失败 body内容为失败的原因
当http返回状态为200时请求处理成功,body内容为返回内容,
请求头信息:
Content-Type:application/json
USER_ID:1234
APP_ID:8000418004
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文:
{
"businessStore": {
"userId": "30518940136629616640",
"name": "齐天超时(王府井店)",
"address": "青海省西宁市城中区129号",
"password": "ERCBHDUYFJDNDHDJDNDJDHDUDHDJDDKDK",
"tel": "15897089471",
"storeTypeCd": "M",
"nearbyLandmarks": "王府井内",
"mapX": "101.801909",
"mapY": "36.597263"
},
"businessStoreAttr": [{
"specCd":"1001",
"value":"01"
}],
"businessStoreCerdentials":[{
"credentialsCd":"300200900001",
"value":"632126XXXXXXXX2011",
"validityPeriod":"3000-01-01",
"positivePhoto":"1234567.jpg",
"negativePhoto":""
}]
}
返回报文:
状态码为 200
成功