SuperAPI AI 工具集

linkfox-shopee-store-media-space

编程与开发

查看项目

更新于 10-15 23:47

技能介绍

用途:封装 Shopee Open Platform MediaSpace 模块的 6 个接口,用于上传商品图片和分片上传视频,并把上传得到的图片 ID 交给商品 listing 技能使用。

主要能力:图片上传经 POST /shopee/uploadMediaSpaceImage 专用端点;其余 JSON API 经 POST /shopee/developerProxy 转发。视频上传流程为 init_video_upload → upload_video_part(循环) → complete_video_upload → get_video_upload_result,另有 cancel_video_upload。包含脚本:init_video_upload.py、upload_video_part.py、complete_video_upload.py、get_video_upload_result.py、cancel_video_upload.py、upload_image.py,以及通用入口 media_space_api.py。

使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装并授权 linkfox-shopee-store-auth;本技能不实现授权与令牌逻辑。图片上传示例:python scripts/upload_image.py '{"shopId":"67890","filePath":"/path/to/image.jpg"}',脚本读取本地文件并 Base64 编码,需传 shopId 与 filePath,不要把 OSS URL 或手工拼接的 multipart body 直接传给 add_item。通用入口:python scripts/media_space_api.py '<JSON 参数>' [--inline]。

输出与限制:完整响应默认写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json,禁止写 /tmp;≤8 KB 打印完整 JSON,>8 KB 只输出摘要,--inline 可强制全量打印。建议先用 jq 或 ConvertFrom-Json 按需抽取字段。本技能不消耗算力。图片上传先看 httpStatus/success/error 后读 imageId;其余接口先看 developerProxy.httpStatus。店铺授权、Media 模块、视频发布、商品 listing 分别由其他技能负责。详细入参与响应见 references/apis/ 下各文档。部分细节暂未提供。