Agent Skills
返回列表
💻

Amazon 店铺 Uploads(文件上传)

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 店铺同系列,核心分两步:

  1. 依赖 linkfox-amazon-store-auth 完成选店(sellerId + region),通过 POST /spApi/developerProxy 调用 createUploadDestinationForResource,由 create_upload_destination_for_resource.py 对应 uploads/2020-11-01/uploadDestinations/{resource}。
  2. 用 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 上传