Amazon 店铺 Uploads(文件上传)
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/linkfox-ai-linkfox-amazon-store-uploads-107。
技能介绍
要解决什么问题
在对接 Amazon Selling Partner API 时,很多能力(A+ 内容、Messaging 附件等)并不让你把二进制直接塞进业务 JSON,而是先向 Uploads API 申请一个带签名的临时目的地,再对返回的 url 做 PUT 上传。若把这套流程与 Orders 或 Feeds 混用,很容易打错路径、重复造轮子,或在网关侧误拦截 uploads/2020-11-01/ 前缀。
技能如何工作
本技能属于 LinkFox Amazon 店铺同系列,核心分两步:
- 依赖 linkfox-amazon-store-auth 完成选店(
sellerId+region),通过 POST/spApi/developerProxy调用 createUploadDestinationForResource,由create_upload_destination_for_resource.py对应uploads/2020-11-01/uploadDestinations/{resource}。 - 用 uploadtodestination.py 对响应里的上传地址执行 PUT(不经网关),并携带返回的 headers;
contentMD5为文件内容的 Base64 MD5,传filePath/content时脚本可自动计算。
脚本默认会把完整响应写入当前工作目录下的聚合 JSON;大响应体 stdout 只给摘要,可用 --inline 强制全量输出。认证与积分异常按 references/onboarding.md 处理(本技能在资料中标注 不消耗积分)。
边界与注意点
- resource 须与下游 API 文档一致(例如 A+:
aplus/2020-11-01/contentDocuments),且 不要带前导/。 - 成功创建目的地常见为 HTTP 201;排查时先看
developerProxy,再看uploadDestination。 - 这是 Uploads API,不是订单接口;批量 Feed 文件请用 linkfox-amazon-store-feeds,订单请用 linkfox-amazon-store-orders。
使用场景
- 已通过 auth 技能选好站点,要为 A+ contentDocuments 申请上传目的地并上传配图
- Messaging 相关资源要求先 createUploadDestination,再用返回 URL 直传附件二进制
- 自动化流水线里需在本地算好 contentMD5,并分步调用创建目的地与 PUT 上传
- 排查 201 响应里 uploadDestination 字段缺失时,对照 developerProxy 原始响应定位网关或 resource 路径
适合人员
- 维护 Amazon A+ 或品牌内容发布脚本、需要按官方两步上传的前端/全栈工程师
- 集成 SP-API Messaging 或附件能力、不熟悉 Uploads 与 Orders 边界的后端开发
- 使用 LinkFox 代理网关的跨境卖家技术对接,负责 Feeds 之外的单文件直传场景
- 负责网关路由配置的运维,需放行 uploads/2020-11-01 且区分不经网关的 PUT 上传