Api-下载分类 ¶

该api为通过接口获取分销系统的产品分类的功能
备注：由于更新大量的产品数据，每个平台有自己独有的类目名与编号，可以做一个Quarkscm类目与您的平台类目匹配的关系表 更方便数据整理。

准备工作 ¶

登录获取access-token,并将access-token设置为请求头参数，如何获取access-token，请参考“获取token文档”

API说明： ¶

URL: https://dpapi.quarkscm.com/v1/catalog/download
URL: https://dpapi.quarkscm.com/v1/catalog/download?lang=en_US

方式：POST

请求参数说明: ¶

url参数： ¶

参数名称	是否必须	类型	描述
lang	可选	String	语言包目前支持语言参数有（en_US , es_ES , ru_RU , de_DE , fr_FR , it_IT , jp_JP , pt_PT , pl_PL , ar_AR）

请求头参数: ¶

参数名称	是否必须	类型	描述
access-token	必须	string	登录后获取的token,此接口access-token必填

返回参数说明 ： ¶

格式：json

参数名称	是否必须	类型	描述
code	必须	integer	状态码
data	不必须	array	请求成功为data数组数据，请求失败则无此参数

返回数据data参数说明： ¶

参数名称	类型	描述
_id	int	分类ID
name	string	分类名称
parent_id	int	父级ID
level	int	层级

返回参数示例： ¶

返回参数详细：

1.成功：返回参数

1.1 全部产品下载成功

{
    "code": 200,
    "data": [
        {
            "_id": "1",
            "name": "Tablet PC & Cellphone",
            "parent_id": 0,
            "level": 1
        },
        {
            "_id": "2",
            "name": "Cell Phones",
            "parent_id": "1",
            "level": 2
        },
    ]
}

2.失败：返回参数

2.1 无分类返回

{
    "code": 401,
    "message": "Not Catalog",
}

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/catalog/download/en_US';
$data['access-token'] = "c_xyXeQgyKcWHM9kS0yukwlC5bgMVJST";
$res = getCurlData($url,'post',$data);
echo $res;
?>

返回json结果：

{
    "code": 200,
    "data": [
       {
            "_id": "1",
            "name": "Tablet PC & Cellphone",
            "parent_id": 0,
            "level": 1
        },
        {
            "_id": "2",
            "name": "Cell Phones",
            "parent_id": "1",
            "level": 2
        }
    ],
}