采购精选批量查询接口

应用场景

查询指定采购精选榜单信息，每月2号上午9点更新上月数据。包括日期、省份、行业类型、类目名称、商品条码、商品名称、排序方式、排名、排名变化、售价中位数（元）、品牌名称。

请求参数

接口名称: top.products.month.bulkget

参数名称	必填	类型	示例	说明
report_date	否	String(10)	2020-04-13	yyyy-MM-dd，每月一号，若不填，默认日期为上个月1号（若当天日期为当月1号、2号，则默认为上上个月1号）

xml请求示例：

<xml>
    <version>1.0.0</version>
    <charset>UTF-8</charset>
    <sign_type>MD5</sign_type>
    <appid>12012325</appid>
    <nonce_str>5K8264ILTKCH16CQ</nonce_str>
    <method>top.products.month.bulkget</method>
    <report_date>2020-04-13</report_date>
    <sign>5AB20AA09142821ABF4A2A38F71303B3</sign>
</xml>

json请求示例：

{
  "version": "1.0.0",
  "charset": "UTF-8",
  "sign_type": "MD5",
  "method": "top.products.month.bulkget",
  "nonce_str": "5K8264ILTKCH16CQ",
  "appid": "12012325",
  "report_date": "2020-04-01",
  "sign": "5AB20AA09142821ABF4A2A38F71303B3"
}

返回结果

参数名称	必填	类型	示例	说明
report_url	是	String(255)	https://img.17gaoda.com/dev/17gaoda/xxx.csv	文件下载地址，文件内容详见[文件字段说明]

文件字段说明：

字段名称	必填	类型	示例	说明
日期	是	String(8)	20200420	yyyyMMdd
省份	是	String(20)	北京市
排名	是	String(20)	1	排名
排名变化	是	String(20)	1	排行变动，正数：下降名次，负数：上升名次，0：持平，null：新上榜
商品条码	是	String(13)	6916168616226
商品名称	是	String(255)	鲁花5S压榨一级花生油1.8L
售价中位数（元）	是	float	59.5
售价中位数（元）	是	float	50.5
类目名称	是	String(20)	非饮料类目
品牌名称	是	String(20)	鲁花
行业类型	是	String(20)	便利店/小超市	行业类型：全部行业、便利店/小超市、标超/卖场

xml返回示例：

<xml>
    <report_url>
        <![CDATA[http://qmgy-oss-private.oss-cn-beijing.aliyuncs.com/reports/yuanqi/yuanqi_Top_Products_20200330-20200412.csv?OSSAccessKeyId=2j9237bV8q625QZy&Expires=1587099998&Signature=os%2F%2FSN%2FoxVdPZduLN5NL6lCZFAc%3D]]>
    </report_url>
    <charset>UTF-8</charset>
    <version>1.0.0</version>
    <sign_type>MD5</sign_type>
    <nonce_str>5e97e7dea79ed</nonce_str>
    <return_code>SUCCESS</return_code>
    <result_code>SUCCESS</result_code>
    <appid>12012325</appid>
    <sign>F2D30010A3D075CDB0BEEE83EFD9CB53</sign>
</xml>

json返回示例：

{
    "report_url": "http://qmgy-oss-private.oss-cn-beijing.aliyuncs.com/reports/yuanqi/yuanqi_Top_Products_20200330-20200412.csv?OSSAccessKeyId=2j9237bV8q625QZy&Expires=1587099998&Signature=os//SN/oxVdPZduLN5NL6lCZFAc=",
    "charset": "UTF-8",
    "version": "1.0.0",
    "sign_type": "MD5",
    "nonce_str": "5e97e812b2f37",
    "return_code": "SUCCESS",
    "result_code": "SUCCESS",
    "appid": "12012325",
    "sign": "E5CF516AFFB1C5648CDD47B2137A1FCC"
}