常见问题

开放平台&聚石塔&服务市场安全违规处理规范
调用网店管家开放平台的接口地址是什么?
-> 无论是测试环境还是正式环境的接口调用,网店管家开放平台接口地址都为同一个:http://api.wdgj.com/wdgjcloud/api
调接口报错:“无效的Method!”
-> 此报错表示接口没有开通,请联系对接的人进行开通。
调接口报错:“参数method不存在”
-> 接口方法不存在,一般为调用者把接口方法写错或者接口方法中多了空格而没有察觉。
调接口报错:“授权已取消!”
-> token无效,开放平台没有对token值授权,请请联系对接的人进行授权。
调接口报错:“xxxxx不能为空!”
-> 请参考接口文档,对应的必填参数不能为空。
调用创建类接口报错:“content格式有误!”
-> content格式可以参考接口文档中的content示例,一般出错多为忽略了创建类接口支持多个单据的创建的这一场景,此外还要注意content的每个节点要和接口文档中对应起来。
json格式的content示例,可进行在线格式化https://www.json.cn/进行查看
{ "tradeList": [ { "warehouse_id": "1201", "trade_no": "123123123", "shop_id": "1092", "tradeTime": "2018-06-12 17:16:48", "receiver_nick": "ewtw", "receiver_name": "rhfg", "receiver_province": "dfh", "receiver_city": "fhd", "receiver_town": "hf", "receiver_address": "fhg", "receiver_mobile": "fh", "bInvoice": "0", "tradeinfo_details": [ { "goods_id": "152037", "spec_id": "", "goods_name": "货品测试2", "sell_count": "12" }, { "goods_id": "152039", "spec_id": "", "goods_name": "货品测试22", "sell_count": "12" } ] }, { "warehouse_id": "1201", "trade_no": "123123123", "shop_id": "1092", "tradeTime": "2018-06-12 17:16:48", "receiver_nick": "ewtw", "receiver_name": "rhfg", "receiver_province": "dfh", "receiver_city": "fhd", "receiver_town": "hf", "receiver_address": "fhg", "receiver_mobile": "fh", "bInvoice": "0", "tradeinfo_details": [ { "goods_id": "152038", "spec_id": "", "goods_name": "货品测试3", "sell_count": "12" } ] } ] }
接口文档中和日期有关的参数的格式是什么?
-> yyyy-MM-dd 00:00:00 或yyyy-MM-dd
调接口报错:" 单次传入记录数不能超过20条!"或"一次性创建订单数不能大于100!"
-> 创建类接口调用时,一次创建的数量有所限制。
对于查询类接口,参"pageno"和"pagesize"如何理解?
-> pageno:页码,pagesize:每页条数,取值范围 1 ~ 100,假设pageno = 1,pagesize = 100,则表示从第一页开始读取数据,每次调取一次查询类接口可获取100条数据,然后pageno加1,则会读取下一页的100条数据,以此类推,直至满足查询条件的数据读取完毕。一般接口不返回总条数,可通过每次获取到的数据条数小于pagesize来判断数据读取完毕。
调接口报错:"参数sign不正确"
-> 报这个错误时,说明已有权限调取接口,不过调取接口时进行的签名验证的sign值不正确,sign的计算包括排序和MD5加密2步,其中排序注意有字典排序(versions=1.0)和ASCII码排序(versions=1.1)2种,开放平台网站上有提供签名校验工具,可以下载工具用来排查排序,签名是否正确。另外计算签名sign的过程中不需要urlencode,只是最终签名计算完毕发送post请求的时候url里的所有参数值需做urlencode编码(当字符串数据以URL的形式传递给web服务器时,字符串中是不允许出现空格和特殊字符的,所以传输之前需要进行urlencode编码)。