达达-开放平台-商户管理-通用模板

第三方服务商
价格:免费使用  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

致力于解决最后三公里的配送问题, 希望帮助众多面向消费者的线上平台实现O2O的商业闭环,让您提高配送效率、节约配送成本。

城市信息


接口地址:http://route.showapi.com/2094-2 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。 
文件上传的POST时,enctype=multipart/form-data。 

1、系统级参数(所有接入点都需要的参数): 

参数名称类型示例值必须描述
showapi_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 

参数名称类型默认值示例值必须描述
source_idString 73753商户编号(创建商户账号分配的编号)
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2094-2","my_appId","my_appSecret") .addTextPara("source_id","73753") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起 

名称类型示例值描述
showapi_res_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口 
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
 
showapi_res_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起 

名称类型示例值描述
code Number0响应返回码,参考接口返回码
msg String成功响应描述
remark String调用成功! 
result Object[] 响应结果,JSON对象,详见具体的接口描述
-  0 Object  
-  cityCode String021城市编码
-  cityName String上海城市名称
ret_code Number0 
status Stringsuccess响应状态,成功为"success",失败为"fail"
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "03a6f38c4c7f45e6901a9eb7474e95a2", "showapi_res_code": 0, "showapi_res_body": { "code": 0, "msg": "成功", "remark": "调用成功!", "result": [ { "cityCode": "021", "cityName": "上海" }, { "cityCode": "010", "cityName": "北京" } ], "ret_code": 0, "status": "success" } }

注册商户


接口地址:http://route.showapi.com/2094-3 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
mobile String
13012345678
注册商户手机号,用于登陆商户后台
city_name String
昆明
商户城市名称(如,上海)
enterprise_name String
昆明xxx公司
企业全称
enterprise_address String
云南省昆明市五华区XX街26号
企业地址
contact_name String
xxx
联系人姓名
contact_phone String
13012345678
联系人电话
email String
11xxxxx46@qq.com
邮箱地址
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2094-3","my_appId","my_appSecret") .addTextPara("mobile","13012345678") .addTextPara("city_name","昆明") .addTextPara("enterprise_name","昆明xxx公司") .addTextPara("enterprise_address","云南省昆明市五华区XX街26号") .addTextPara("contact_name","xxx") .addTextPara("contact_phone","13012345678") .addTextPara("email","11xxxxx46@qq.com") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
code Number
0
响应编码
msg String
成功
响应描述
remark String
调用成功!
返回说明
result Number
76761
商户id
ret_code Number
0
status String
success
响应状态
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "cdf8fb076c434225bcb17772c59aa7b0", "showapi_res_code": 0, "showapi_res_body": { "code": 0, "msg": "成功", "remark": "调用成功!", "result": 76761, "ret_code": 0, "status": "success" } }

门店创建


接口地址:http://route.showapi.com/2094-4 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
source_id String
73753
商户编号(创建商户账号分配的编号)
station_name String
新门店1
门店名称
business Number
1
业务类型(食品小吃-1,饮料-2,鲜花-3,文印票务-8,便利店-9,水果生鲜-13,同城电商-19, 医药-20,蛋糕-21,酒品-24,小商品市场-25,服装-26,汽修零配-27,数码-28,小龙虾-29, 其他-5)
city_name String
上海
城市名称(如,上海)
area_name String
浦东新区
区域名称(如,浦东新区)
station_address String
地址1
门店地址
lng Number
121.515014
门店经度
lat Number
31.229081
门店纬度
contact_name String
xxx
联系人姓名
phone String
13012345678
联系人电话
origin_shop_id String
shop001
门店编码,可自定义,但必须唯一;若不填写,则系统自动生成
id_card String
联系人身份证
username String
达达商家app账号(若不需要登陆app,则不用设置)
password String
达达商家app密码(若不需要登陆app,则不用设置)
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2094-4","my_appId","my_appSecret") .addTextPara("source_id","73753") .addTextPara("station_name","新门店1") .addTextPara("business","1") .addTextPara("city_name","上海") .addTextPara("area_name","浦东新区") .addTextPara("station_address","地址1") .addTextPara("lng","121.515014") .addTextPara("lat","31.229081") .addTextPara("contact_name","xxx") .addTextPara("phone","13012345678") .addTextPara("origin_shop_id","shop001") .addTextPara("id_card","") .addTextPara("username","") .addTextPara("password","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
code Number
0
响应编码
msg String
成功
响应描述
remark String
调用成功!
返回说明
result Object
返回结果
failedList String[]
[]
导入失败门店编号以及原因
success Number
1
成功导入门店的数量
successList Object[]
成功导入的门店
0 Object
areaName String
浦东新区
区域名称(如,浦东新区)
business Number
1
业务类型(食品小吃-1,饮料-2,鲜花-3,文印票务-8,便利店-9,水果生鲜-13,同城电商-19, 医药-20,蛋糕-21,酒品-24,小商品市场-25,服装-26,汽修零配-27,数码-28,小龙虾-29, 其他-5)
cityName String
上海
城市名称(如,上海)
contactName String
xxx
联系人姓名
lat Number
31
门店纬度
legalId String
lng Number
122
门店经度
originShopId String
shop06346346
门店编码
password String
达达商家app密码
phone String
13012345678
联系人电话
stationAddress String
地址1
门店地址
stationName String
新门店1
门店名字
username String
达达商家app账号
ret_code Number
0
status String
success
响应状态
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "645458c0ad98427d830abf7c5db96816", "showapi_res_code": 0, "showapi_res_body": { "code": 0, "msg": "成功", "remark": "调用成功!", "result": { "failedList": [], "success": 1, "successList": [ { "areaName": "浦东新区", "business": 1, "cityName": "上海", "contactName": "xxx", "lat": 31.229081, "legalId": "", "lng": 121.515014, "originShopId": "shop06346346", "password": "", "phone": "13012345678", "stationAddress": "地址1", "stationName": "新门店1", "username": "" } ] }, "ret_code": 0, "status": "success" } }

门店更新


接口地址:http://route.showapi.com/2094-5 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
source_id String
73753
商户编号(创建商户账号分配的编号)
origin_shop_id String
shop001
门店编码
new_shop_id String
shop002
新的门店编码
station_name String
门店名称
business Number
业务类型(食品小吃-1,饮料-2,鲜花-3,文印票务-8,便利店-9,水果生鲜-13,同城电商-19, 医药-20,蛋糕-21,酒品-24,小商品市场-25,服装-26,汽修零配-27,数码-28,小龙虾-29, 其他-5)
city_name String
城市名称(如,上海)
area_name String
区域名称(如,浦东新区)
station_address String
门店地址
lng Number
门店经度
lat Number
门店纬度
contact_name String
联系人姓名
phone String
联系人电话
status Number
门店状态(1-门店激活,0-门店下线)
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2094-5","my_appId","my_appSecret") .addTextPara("source_id","73753") .addTextPara("origin_shop_id","shop001") .addTextPara("new_shop_id","shop002") .addTextPara("station_name","") .addTextPara("business","") .addTextPara("city_name","") .addTextPara("area_name","") .addTextPara("station_address","") .addTextPara("lng","") .addTextPara("lat","") .addTextPara("contact_name","") .addTextPara("phone","") .addTextPara("status","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
code Number
0
响应编码
msg String
成功
响应描述
remark String
调用成功!
返回结果
ret_code Number
0
status String
success
响应状态
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "d85786f39cf648669f677a0efd1caf56", "showapi_res_code": 0, "showapi_res_body": { "code": 0, "msg": "成功", "remark": "调用成功!", "ret_code": 0, "status": "success" } }

门店详情


接口地址:http://route.showapi.com/2094-6 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
source_id String
73753
商户编号(创建商户账号分配的编号)
origin_shop_id String
shop001
门店编码
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2094-6","my_appId","my_appSecret") .addTextPara("source_id","73753") .addTextPara("origin_shop_id","shop001") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
code Number
0
响应编码
msg String
成功
响应描述
remark String
调用成功!
result Object
返回结果
area_name String
静安区
区域名称
business Number
1
业务类型(餐饮-1,商超-9,水果生鲜-13,蛋糕-21,酒品-24,鲜花-3,其他-5)
city_name String
上海
城市名称
contact_name String
xxx
联系人姓名
id_card String
联系人身份证
lat Number
31
门店纬度
lng Number
122
门店经度
origin_shop_id String
shop001
门店编码
phone String
13012345678
联系人电话
station_address String
地址2
门店地址
station_name String
新门店2
门店名称
status Number
0
门店状态(1-门店激活,0-门店下线)
ret_code Number
0
status String
success
响应状态
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "51fd5d57420d4046a219099f454a509b", "showapi_res_code": 0, "showapi_res_body": { "code": 0, "msg": "成功", "remark": "调用成功!", "result": { "area_name": "静安区", "business": 1, "city_name": "上海", "contact_name": "xxx", "id_card": "", "lat": 31.229081, "lng": 121.515014, "origin_shop_id": "shop001", "phone": "13012345678", "station_address": "地址2", "station_name": "新门店2", "status": 0 }, "ret_code": 0, "status": "success" } }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种API操纵资源。

截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。

 

联系方式:

电话: 4009988033

 

微博: http://www.weibo.com/showapi

 

邮箱: services@showapi.com

 

QQ: 3007663665

 

微信: show_api

进制数据介绍:

企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。

 

 

联系我们:

电话:173-6457-5198

QQ① 群:792473404

客服 QQ:1643296538

微信客服:binstds

                                      扫描二维码添加客服微信

 

 

工作时间

 周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00) 

周六 9:00 - 12:00(节假日除外) 

 

 

进制数据团队

 

 

2020.01.01

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐