用途:面向 Shopee 开放平台 Media 模块,通过 LinkFox 网关完成店铺媒体文件上传,包括图片上传与视频分片上传,并可与商品发布流程衔接。
主要能力:覆盖 Media 模块全部 6 个 API——upload_image(POST)、init_video_upload(POST)、upload_video_part(POST)、complete_video_upload(POST)、get_video_upload_result(GET)、cancel_video_upload(POST);提供 media_api.py 通用入口及对应单接口脚本。
调用方式:API 端点为 POST /shopee/developerProxy,不同操作由请求体区分,需传入 shopId(或 merchantId),由服务端解析 token 转发;脚本用法为 python scripts/media_api.py '<JSON 参数>' [--inline]。使用前运行 python scripts/check_auth_dependency.py,若 exit code 42 需先安装 linkfox-shopee-store-auth;本技能内不实现授权与令牌逻辑。
输出与限制:完整响应默认写入当前工作目录下 linkfox/<日期>/<session>/data/ 的 JSON 文件,禁止写 /tmp;响应体不超过 8KB 时全量打印,超过则只输出摘要,--inline 可强制全量打印。建议先读摘要,再用 jq 或 ConvertFrom-Json 按需抽取字段。会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探,需继续检索应先告知用户。未配置 API Key、返回 401/402 或提示算力不足时,按 references/onboarding.md 处理。注意与 MediaSpace 区分:后者 path 前缀为 api/v2/media_space/...(module=91),应使用 linkfox-shopee-store-media-space;店铺授权用 linkfox-shopee-store-auth,视频发布用 linkfox-shopee-store-video。官方参考与接口细节见 references/api.md 与 references/apis/ 下文档。