Api-获取产品SPU ¶
该api为通过接口获取产品SPU 备注:
- 如果是查询增量,最多只能查询最近三个月的上新产品SPU。
准备工作 ¶
登录获取access-token,并将access-token设置为请求头参数,如何获取access-token,请参考“获取token文档”
API说明: ¶
URL: https://dpapi.quarkscm.com/v1/myproduct/products
格式:JSON
方式:POST
请求参数说明: ¶
请求头参数: ¶
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
access-token | 必须 | string | 登录后获取的token,此接口access-token必填 |
Body Form-Data: ¶
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
lastId | 必须 | string | 下一页标志(第一页不传),直至lastId为空结束 |
createdDate | 选填 | string | 产品创建时间,表示获取这个日期后面创建的产品。最多查询最近三个月的增量数据,格式为:1900-01-01,不传则是查询全部产品 |
warehouse_name | 选填 | string | 仓库名(见文档下方说明),不填则获取SZ1仓库的产品 |
请求参数示例如下:
{
"lastId": "59e4243a3e00ca1498564174",
"createdDate": "1900-01-01",
"warehouse_name": "SZ1",
}
返回参数说明 : ¶
格式:json
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
code | 必须 | integer | 状态码 |
data | 不必须 | array | 请求成功为data数组数据,请求失败则无此参数 |
message | 不必须 | string | 请求失败返回错误信息,请求成功则无此参数 |
返回参数示例: ¶
返回参数详细:
1.成功:返回参数
{
"code": 200,
"status": "success",
"data": {
"count": 478,
"pageCount": 1,
"lastId": "59e4243a3e00ca1498564174",
"numPerPage": 500,
"coll": [
"S5855",
"S5868",
...
]
}
}
php 代码示例: ¶
<?php
function getCurlData($url,$type="get",$data=array(),$timeout = 10) {
//对空格进行转义
$http_header = array();
if(isset($data['access-token'])){
$http_header[] = 'access-token: ' . $data['access-token'];
unset($data['access-token']);
}
$url = str_replace(' ','+',$url);
if (strtolower($type) == "get") {
if (!empty($data) && is_array($data)) {
$arr = [];
foreach ($data as $k=>$v) {
$arr[] = $k."=".$v;
}
$str = implode("&",$arr);
if (strstr($url,"?")) {
$url .= "&".$str;
} else {
$url .= "?".$str;
}
}
}
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "$url");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch,CURLOPT_TIMEOUT,$timeout); //定义超时3秒钟
if(strtolower($type) == "post"){
$data = json_encode($data);
// POST数据
curl_setopt($ch, CURLOPT_POST, 1);
$http_header[] = 'Accept: application/json';
$http_header[] = 'Content-Type: application/json';
$http_header[] = 'Content-Length: ' . strlen($data);
// 把post的变量加上
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
}
curl_setopt($ch, CURLOPT_HTTPHEADER,$http_header);
//执行并获取url地址的内容
$output = curl_exec($ch);
//echo $output ;
//释放curl句柄
curl_close($ch);
//var_dump($output);exit;
return $output;
}
$url = 'https://dpapi.quarkscm.com/v1/myproduct/products';
$data['access-token'] = "c_xyXeQgyKcWHM9kS0yukwlC5bgMVJST";
$res = getCurlData($url,'post',$data);
echo $res;
?>
仓库代码解释: ¶
中国:SZ1美国:US3、US5、US6、US7、US10、US12、QK1、QK2、QK3、QK4
英国:UK4、UK5、UK6、UK7、UK8、UK9、UK11、QK1、QK3、QK4
德国:DE4、DE7、DE8、QK1、QK2、QK4
捷克:CZ1、CZ3、CZ4
法国:FR1、FR3、QK1、QK2
西班牙:ES4、ES5、QK1、QK3
俄罗斯:RU5、QK3
意大利:IT1、QK1
澳大利亚:AU1、AU3、QK1
墨西哥:MX4
加拿大:CA1、CA5