大淘客,让选品更简单! |

{{item.type_name}}:

API 市场 / 超级分类
 

超级分类
吐槽建议
应用场景:
一般用于首页顶部的导航栏或者分类栏目,获取商品的一二级分类
接口说明:
返回大淘客所有的一级分类和二级分类,且提供一级分类图标及二级分类图标素材
使用人数: 8000+
超级分类 接口测试 建议使用通用GET方法调用
  • 接口说明
  • 更新日志
  • 接口版本号:v1.1.0

请求地址:https://openapi.dataoke.com/api/category/get-super-category 复制

请求方式:GET

公共参数:
请求参数:

注:请求参数须区分大小写

返回数据:
调用示例:
String url = "https://openapi.dataoke.com/api/category/get-super-category";
String appKey = "xxx";
String appSecret = "xxx";
TreeMap<String, String> paraMap = new TreeMap<>();
paraMap.put("version", "v1.1.0");
paraMap.put("appKey", appKey);
String data = ApiClient.sendReq(url, appSecret, paraMap);

SDK调用示例
String appKey = "xxx";
String appSecret = "xxx";
DtkApiClient client = DtkApiClient.getInstance(appKey,appSecret);
DtkGetSuperCategoryRequest request = new DtkGetSuperCategoryRequest();
request.setVersion("v1.0.0");
DtkApiResponse < List < DtkGetSuperCategoryResponse >> execute = client.execute(request);
 //超级分类
    $data = [
        'appKey' => "xxxxxxxxxxxx",
        'version' => "v1.0.0",
        ...
    ];
    $host = "https://openapi.dataoke.com/api/category/get-super-category";
    $url = $host . '?' . http_build_query($data);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, $this->timeout);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    $output = curl_exec($ch);
    $a = curl_error($ch);
    if(!empty($a)){
        return json_encode(array('code'=>10003, 'msg'=>$a));
    }
    curl_close($ch);
    return $output;

    SDK调用示例
    $client = new GetSuperCategory();
    $client->setAppKey("xxxxxxxxx");
    $client->setAppSecret("xxxxxxxxxxxxxxxxxxxxxxxxx");
    $client->setVersion("v1.0.0");

    $res = $client->setParams([])->request();

package main

import (
	"fmt"
	"gitee.com/dtk-developer/openapi-sdk-go/sdk"
)

func main() {
	// 1.初始化所需要的参数appKey, appSecret, version
	var (
		appKey = "xxxxxxxxxx"
		appSecret = "xxxxxxxxxx"
		version = "v1.3.1"
	)

	// 2.初始化开放平台api的客户端句柄
	oa := &sdk.OpenApi{}
	oa.AppKey = appKey
	oa.AppSecret = appSecret
	oa.Version = version
	client :=  oa.GetClient()

	// 3.准备请求参数
	params := map[string]string {
	}

	// 4.业务请求,示例使用超级分类和淘系万能解析接口,其它开放接口使用方法相同
	resp, err := client.GetSuperCategory(params)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp)

	// 复用client句柄
	params = map[string]string {
		// 指定接口版本
		"version": "v1.0.0",
		"content": "1👈¥fym8XiJU9Oi¥ https://s.click.taobao.com/Ys3TNlu  包邮 漫花抽纸10包4层加厚280张/包纸巾卫生纸家用实惠装面巾纸",
	}
	resp, err = client.ParseContent(params)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp)
}
返回示例:
{
	"status": 200,
	"data": {
		"time": 1589010833075,
		"code": 0,
		"msg": "成功",
		"data": [{
			"cid": 6,
			"cname": "美食",
			"cpic": "https://img.alicdn.com/imgextra/i3/2053469401/O1CN01hKSnoI2JJhz2bCgzy_!!2053469401.png",
			"subcategories": [{
				"subcid": 117944,
				"subcname": "懒人速食",
				"scpic": "https://img.alicdn.com/imgextra/i1/2053469401/TB2gO5rtr1YBuNjSszhXXcUsFXa-2053469401.png"
			}, {
				"subcid": 116908,
				"subcname": "无辣不欢",
				"scpic": "https://img.alicdn.com/imgextra/i2/2053469401/O1CN01U0MPiS2JJhzxMn5rO_!!2053469401.png"
			}, {
				"subcid": 90318,
				"subcname": "快捷早餐",
				"scpic": "https://img.alicdn.com/imgextra/i3/2053469401/O1CN01C4slBs2JJhx2jaYcm_!!2053469401.png"
			}, {
				"subcid": 8409,
				"subcname": "休闲零食",
				"scpic": "https://img.alicdn.com/imgextra/i2/2053469401/O1CN01aOer0W2JJhzuGlt4R_!!2053469401.png"
			}, {
				"subcid": 117943,
				"subcname": "生鲜果蔬",
				"scpic": "https://img.alicdn.com/imgextra/i2/2053469401/TB22X0WwuGSBuNjSspbXXciipXa-2053469401.png"
			}, {
				"subcid": 116910,
				"subcname": "肉食主义",
				"scpic": "https://img.alicdn.com/imgextra/i3/2053469401/O1CN01M0Y1rP2JJhzpF6ZTN_!!2053469401.png"
			}, {
				"subcid": 117945,
				"subcname": "酒水饮品",
				"scpic": "https://img.alicdn.com/imgextra/i3/2053469401/TB27SJFtv9TBuNjy0FcXXbeiFXa-2053469401.png"
			}, {
				"subcid": 116909,
				"subcname": "幸福甜品",
				"scpic": "https://img.alicdn.com/imgextra/i4/2053469401/O1CN01biWHsP2JJhzwYA0ym_!!2053469401.png"
			}, {
				"subcid": 116914,
				"subcname": "坚果蜜饯",
				"scpic": "https://img.alicdn.com/imgextra/i4/2053469401/O1CN011dKaxO2JJhx7VtBl0_!!2053469401.png"
			}, {
				"subcid": 117941,
				"subcname": "佳节美食",
				"scpic": "https://img.alicdn.com/imgextra/i4/2053469401/O1CN01MeFzM02JJi0KotvgG_!!2053469401.png"
			}, {
				"subcid": 117942,
				"subcname": "粮油调味",
				"scpic": "https://img.alicdn.com/imgextra/i2/2053469401/TB2U5uHtxSYBuNjSspjXXX73VXa-2053469401.png"
			}]
		}]
	},
	"msg": "请求成功"
}
常见错误码:
{
    "msg":"服务器错误",
    "code":-1,
    "time":1554365022200
}
错误码列表: