获取行业分类配置/Get industry category config

[中文]

用途:

• 获取抖音创作者平台的行业分类配置
• 返回所有可用的行业分类层级结构
• 建议在调用商单任务列表接口前先调用此接口获取完整的行业分类信息

重要说明:

• 此接口已优化为Redis缓存，首次调用后数据将缓存30天
• 缓存键: douyin_creator:industry_categories
• 数据结构包含一级行业和二级行业的完整映射关系

数据结构:

{
    "status_code": 0,
    "status_msg": "success",
    "data": {
        "industry_categories": [
            {"key": "-1", "label": "全部"},
            {"key": 1901, "label": "3C及电器"},
            {"key": 1913, "label": "游戏"},
            ...
        ],
        "industry_subcategories": {
            1913: [
                {"key": "-1", "label": "全部"},
                {"key": 191301, "label": "休闲游戏"},
                {"key": 191302, "label": "棋牌桌游"},
                ...
            ],
            ...
        }
    }
}

在商单任务筛选中的使用:

1. 获取全部行业任务: industry_lv1=-1 (此时industry_lv2无需设置)
2. 获取特定一级行业: industry_lv1=1913 (游戏行业)
3. 获取特定二级行业: industry_lv1=1913&industry_lv2=191301 (游戏-休闲游戏)

性能优化:

• 首次调用时从本地JSON文件读取并缓存到Redis
• 后续调用直接从Redis缓存读取，大幅提升响应速度
• 缓存有效期30天，确保数据时效性

返回:

• 返回完整的行业分类树结构
• 包含32个一级行业分类和对应的二级行业分类
• 每个分类包含分类ID(key)和名称(label)

[English]

Purpose:

• Get industry category configuration from Douyin Creator platform
• Returns all available industry classification hierarchy
• Recommend calling this API first before using mission task list API to get complete industry classification info

Important Notes:

• This API is optimized with Redis caching, data will be cached for 30 days after first call
• Cache key: douyin_creator:industry_categories
• Data structure contains complete mapping relationship between primary and secondary industries

Data Structure:

{
    "status_code": 0,
    "status_msg": "success",
    "data": {
        "industry_categories": [
            {"key": "-1", "label": "All"},
            {"key": 1901, "label": "3C & Electronics"},
            {"key": 1913, "label": "Gaming"},
            ...
        ],
        "industry_subcategories": {
            1913: [
                {"key": "-1", "label": "All"},
                {"key": 191301, "label": "Casual Games"},
                {"key": 191302, "label": "Board Games"},
                ...
            ],
            ...
        }
    }
}

Usage in Mission Task Filtering:

1. Get all industry tasks: industry_lv1=-1 (industry_lv2 not needed)
2. Get specific primary industry: industry_lv1=1913 (Gaming industry)
3. Get specific secondary industry: industry_lv1=1913&industry_lv2=191301 (Gaming-Casual Games)

Performance Optimization:

• First call reads from local JSON file and caches to Redis
• Subsequent calls read directly from Redis cache, significantly improving response speed
• Cache validity period of 30 days ensures data timeliness

Return:

• Returns complete industry classification tree structure
• Contains 32 primary industry categories and corresponding secondary industry categories
• Each category contains category ID(key) and name(label)

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.