SuperAPI AI 工具集

linkfox-amazon-store-uploads

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:向 Amazon 申请上传目的地并上传文件,适用于 A+ Content、Messaging 等需要先创建 upload destination 再上传图片或附件的业务。这是 Uploads API,不是 Orders 订单接口;批量 Feed 文件见 linkfox-amazon-store-feeds。

主要能力:通过 POST /spApi/developerProxy 调用 createUploadDestinationForResource 创建上传目的地,返回 uploadDestinationId、url、headers;再用 upload_to_destination.py 对返回 URL 执行 PUT(不经网关)。传 filePath 或 content 时脚本可自动计算 contentMD5(待上传文件内容的 Base64 MD5 摘要)。

使用方式:依赖 linkfox-amazon-store-auth 选店(sellerId+region)。脚本调用格式为 python scripts/<脚本名>.py '<JSON 参数>' [--inline]。先运行 create_upload_destination_for_resource.py 创建目的地,再将返回的 uploadDestination 传入 upload_to_destination.py 上传。resource 须与下游 API 文档一致,例如 A+ 为 aplus/2020-11-01/contentDocuments,Messaging 为对应 messages 资源路径;resource 传未编码路径,不得预编码成 %2F。成功创建目的地常为 HTTP 201。

输出策略:完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下的 JSON 文件;响应体 ≤8KB 打印完整 JSON,>8KB 只输出摘要,加 --inline 强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需抽取字段。

限制:本工具会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探。同一店铺连续收到 400、403、404、429 时网关返回 450、453、454、459 并短暂冷却,需按指引停止重试、修正参数或授权,冷却后最多谨慎重试一次。未配置 API Key 或遇 401/402、余额不足时按 onboarding 文档处理。算力消耗规则:不消耗算力。