核心内容摘要
光影的探秘之旅：深度解析麻豆文化传媒精品1区、2区、3区的极致魅力
前置准备必须完成和之前一致这是调用所有 1688 开放 API 的前提缺一不可访问1688 开放平台注册开发者账号并完成实名认证个人 / 企业均可。
创建应用获取核心凭证app_key应用 ID、app_secret应用密钥。
为应用申请alibaba.category.get接口的调用权限类目查询专用免费申请。
了解核心规则接口请求需要生成MD5 签名时间戳为 13 位毫秒级避免请求过期。
核心实现获取 1688 商品类目
接口关键信息聚焦类目获取请求地址https://gw.open.
com/openapi/param2/2/portals.open/api/getCategory请求方式GET更简单适合新手数据格式JSON返回结果易解析频率限制单应用 QPS≤10日调用≤5 万次类目更新慢建议本地缓存 24 小时以上
完整 Python 代码可直接运行该代码会拉取全量类目树并以层级化格式打印方便你查找目标类目及其 ID。
python运行import requests import hashlib import time # ---------------------- 配置区替换为你自己的凭证 ---------------------- app_key 你的_app_key app_secret 你的_app_secret # ------------------------------------------------------------------------ # 接口请求地址 category_api_url https://gw.open.
com/openapi/param2/2/portals.open/api/getCategory def generate_md5_sign(params, app_secret): 生成1688 API要求的MD5签名 规则app_secret 按字母序拼接的参数键值对 app_secretMD5加密后转大写 # 按参数名字母顺序排序 sorted_params sorted(params.items()) # 拼接参数字符串无分隔符直接键值相连 param_str .join([f{k}{v} for k, v in sorted_params]) # 构造签名原始字符串 sign_origin app_secret param_str app_secret # 生成MD5签名并转大写 md5_obj hashlib.md5(sign_origin.encode(utf-
) return md5_obj.hexdigest().upper() def get_1688_categories(): 调用1688接口获取完整商品类目树 #
构造基础请求参数接口要求的必填参数 base_params { method: alibaba.category.get, # 固定接口方法名 app_key: app_key, # 你的应用ID timestamp: str(int(time.time() *
), # 13位毫秒级时间戳 format: json, # 返回数据格式固定为json v:
0, # 接口版本固定为
0 sign_method: md5 # 签名方式固定为md5 } #
生成签名并添加到参数中 base_params[sign] generate_md5_sign(base_params, app_secret) #
发送GET请求 try: response requests.get(category_api_url, paramsbase_params, timeout
response.raise_for_status() # 抛出HTTP请求错误如
500 return response.json() except requests.exceptions.RequestException as e: print(f请求失败{e}) return None def parse_and_print_categories(categories, level
: 递归解析类目树层级化打印类目信息名称、ID、层级、是否叶子类目 :param categories: 类目列表接口返回的children数组 :param level: 类目层级用于缩进提升可读性 for cat in categories: # 提取核心类目信息 cat_id cat.get(categoryId, 未知ID) cat_name cat.get(name, 未知名称) cat_level cat.get(level, 未知层级) is_leaf cat.get(isLeaf, False) # 是否为叶子类目不可再下钻 leaf_tag [叶子类目] if is_leaf else [可下钻] # 层级化打印 indent * level print(f{indent}[L{cat_level}] {cat_name}ID{cat_id}{leaf_tag}) # 递归打印子类目 if children in cat and cat[children] and len(cat[children]) 0: parse_and_print_categories(cat[children], level
# ---------------------- 执行主流程 ---------------------- if __name__ __main__: #
获取类目数据 category_result get_1688_categories() if not category_result: print(未获取到类目数据) exit(
#
解析并打印类目接口返回数据有固定结构 try: # 提取核心类目列表 category_list category_result[result][categories] print( *
print(1688商品类目树层级化展示可直接复制目标类目ID) print( *
parse_and_print_categories(category_list) except KeyError as e: print(f解析类目数据失败缺少字段{e}) print(f接口返回完整数据{category_result})
代码使用说明替换配置区的app_key和app_secret为你在开放平台获取的真实凭证。
安装依赖若未安装执行pip install requests。
运行代码控制台会输出层级化的类目列表示例效果如下plaintext[L1] 服装服饰ID10000[可下钻] [L2] 女装ID10001[可下钻] [L3] 上衣ID10002[可下钻] [L4] T恤ID10003[叶子类目] [L4] 衬衫ID10004[叶子类目]查找你需要的类目复制对应的categoryId即可后续调用榜单、商品列表等接口都会用到。
关键字段解释新手必看字段名含义实用价值categoryId类目唯一 ID后续接口的核心入参必须准确name类目中文名称用于识别类目方便人工筛选level类目层级1 级为顶级类目如服装服饰5 级为最细分类目isLeaf是否为叶子类目true表示该类目无下级子类目是最细分类选品时常用
三、
常见问题排查签名错误返回 invalid sign检查app_secret是否填写正确不可多空格、少字符。
确认参数是否按字母序排序代码已实现无需手动修改。
时间戳是否为 13 位毫秒级代码中time.time() * 1000已处理。
权限不足返回 403 Forbidden未申请alibaba.category.get接口权限需在开放平台应用的「权限管理」中补充申请并等待审核通过。
返回数据为空检查网络连接或等待几分钟后重试开放平台偶尔有临时波动。
确认账号已完成实名认证未认证账号无法调用接口。
总结获取 1688 商品类目核心是调用alibaba.category.get接口前提是完成开放平台的账号认证、应用创建和权限申请。
接口请求必须生成符合规则的 MD5 签名否则会请求失败。
类目数据层级化递归解析核心目标是提取categoryId为后续调取榜单、商品数据打下基础。