Amazon SP-API文档看着累?那就看这里!

2023-10-30 21:48
文章标签 文档 api sp amazon 看着

本文主要是介绍Amazon SP-API文档看着累?那就看这里!,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

我们做跨境电商搞亚马逊API开发的都懂,首先就是文档的事情,亚马逊写的中文文档很坑啊有木有!!(本来英文文档就挺坑的了,小声BB~)

好了,就是要吐槽它一波~现在我们进入正题~

我们团队考虑到很多做亚马逊API开发的朋友们,初期都要经过看文档这个枯燥又乏味的过程,然后我们寻思要不就写一篇API导航?我直呼好家伙,反响还挺大,毕竟这玩意写一次参考价值也是不菲的~

好了好了!不扯来扯去的了!想必你们都嫌我烦了!接下来我们正式进入正题!!

我们就先将 Amazon SP-API references ⬅️ 这里的API它的用途分析一遍(由于API比较多,我们今天先说一部分哦,体谅一下)

前情提要

以下所有API的请求路径全部以 Selling Partner API endpoints 开头哦~

Selling Partner API endpoints ⬇️

Selling regionendpoint
北美地区(加拿大、美国、墨西哥、巴西)市场https://sellingpartnerapi-na.amazon.com
欧洲地区(西班牙、英国、法国、德国、意大利、瑞典、波兰、土耳其、阿联酋、印度)市场https://sellingpartnerapi-eu.amazon.com
远东地区(新加坡、澳大利亚、日本)市场https://sellingpartnerapi-fe.amazon.com

Selling Partner API for Catalog Items

文档位置戳这里,可以比对着看更清晰 ➡️ catalogItems_2020-12-01.md

这个API它的最新版本是 2020-12-01 版本,原先是有一套老版本的 ➡️ catalogItemsV0.md。我们就只说新版本了哦~~

API概览

卖家可以通过此API获取Amazon店铺内所有ASIN的汇总的详细信息等。

API详情

版本号:2020-12-01

请求速率:每秒 5

API列表 ⬇️

请求方法路径参数描述
GETcatalog/2020-12-01/items/{asin}asin(必须的)marketplaceIds(必须的)includedData(可选的)获取店铺内ASIN的汇总的详细信息

各API请求参数

  • GET catalog/2020-12-01/items/{asin}
    • 路径参数:asin ➡️ 参数放在路径中,只允许一个asin,会根据asin查找其详细信息
    • 参数:marketplaceIds ➡️ 逗号分隔的市场ID(支持传入多个市场ID)。例:英,加,美,德,法
    • 参数:includedData ➡️ 将你所需要返回的数据内容的名称以逗号分隔的方式传入(仅对品牌所有者有效)

includedData ⬇️

描述
identifiers与此ASIN相关联的标识符(UPC、EAN等)
images此ASIN的商品图片链接
productTypes与此ASIN有关联的产品品类
salesRanks亚马逊商品的销售排名
summaries此ASIN的详细信息
variations此ASIN的父子ASIN关系,并返回其父ASIN
vendorDetails与此ASIN关联的供应商详细信息(只有供应商可以使用此参数)
attributes此ASIN的属性相关信息(只有品牌所有者可以使用此参数)

各API响应参数

  • Response catalog/2020-12-01/items/{asin}
名称描述概要
asin亚马逊标准识别号码(ASIN)是Amazon商品的唯一标识符唯一标识符
attributes此ASIN的属性相关信息属性信息的JSON
identifiers与此ASIN相关联的标识符(UPC、EAN等)返回例如UPC, EAN或者ISBN的标识符
images此ASIN的商品图片链接返回图片链接, 长宽高等数据
productTypes与此ASIN有关联的产品品类返回关联的产品品类
salesRanks亚马逊商品的销售排名返回销售排名相关信息
summaries此ASIN的详细信息返回品牌, 颜色, 产品名称, 制造商等
variations此ASIN的父子ASIN关系,并返回其父ASIN返回ASIN的关系类型等
vendorDetails与此ASIN关联的供应商详细信息(只有供应商可以使用此参数)返回品牌, 类别, 产品组, 供应商代码等

Selling Partner API for FBA Inbound Eligibilty

文档位置戳这里,可以比对着看更清晰 ➡️ fbaInbound.md

API概览

卖家可以通过此API获取商品是否可以通过FBA入库的相关信息。

API详情

版本号:v1

请求速率:每秒 1

API列表 ⬇️

请求方法路径参数描述
GET/fba/inbound/v1/eligibility/itemPreviewasin(必须的)program(必须的)marketplaceIds(可选的)获取商品是否可以通过FBA入库的相关信息

各API请求参数

  • GET /fba/inbound/v1/eligibility/itemPreview
    • 参数:asin ➡️ 想要查询的ASIN
    • 参数:Program ➡️ 传入查询使用的程序
    • 参数:marketplaceIds ➡️ 市场ID,当program=INBOUND时必须传入

Program ⬇️

描述
INBOUND检查商品入库的程序
COMMINGLING使用条形码进行物流跟踪的程序

各API响应参数:

  • Response /fba/inbound/v1/eligibility/itemPreview
名称描述概要
asin查询的ASINstring
marketplaceId要查询的市场string
program查询使用的程序INBOUND, COMMINGLING
isEligibleForProgram是否符合FBA需求boolean
ineligibilityReasonList不符合的原因返回原因的code

Selling Partner API for FBA Inventory

文档位置戳这里,可以比对着看更清晰 ➡️ fbaInventory.md

API概览

卖家可以通过此API获取库存相关信息。

API详情

版本号:v1

请求速率:每秒 90

API列表 ⬇️

请求方法路径参数描述
GET/fba/inventory/v1/summariesmarketplaceIds(必须的)granularityType(必须的)granularityId(必须的)details(可选的)startDateTime(可选的)sellerSkus(可选的)nextToken(可选的)获取商品是否可以通过FBA入库的相关信息

各API请求参数

  • GET /fba/inventory/v1/summaries
    • 参数:marketplaceIds ➡️ 要查询的市场ID,只能查询一个市场
    • 参数:granularityType ➡️ 库存的汇总粒度(以市场为单位)
    • 参数:granularityId ➡️ 库存汇总的粒度ID(市场ID)
    • 参数:details ➡️ 为true则返回库存明细数据。默认只返回库存概要
    • 参数:startDateTime ➡️ 指定开始日期,不得早于当前时间前18个月。时间为ISO8601(UTC世界时间)。例:2021-01-01T00:00:00Z
    • 参数:sellerSkus ➡️ 最多指定50个商品的卖方SKU,指定后查询这些SKU的数据
    • 参数:nextToken ➡️ 如需调用下一部分数据则传入此参数

各API响应参数:

  • Response /fba/inventory/v1/summaries
名称描述概要
asin亚马逊标准识别号码(ASIN)是Amazon商品的唯一标识符string
fnSkuFBA的产品标签编码string
sellerSku商品的卖方SKUstring
condition卖方的商品描述。例:New Itemstring
inventoryDetails库存明细信息,如果请求参数 details 为 false 则无此数据见下方明细
lastUpdatedTime库存上次更新的时间string (date-time)
productName产品的标题信息string
totalQuantity正在入库的商品数量和已经在库存中的商品数量integer

inventoryDetails ⬇️

名称描述
fulfillableQuantity可拣选,包装,运输的货品数
inboundWorkingQuantity通知亚马逊入库的货品数
inboundShippedQuantity通知亚马逊并有物流跟踪号的货品数
inboundReceivingQuantity亚马逊物流未处理的入库货数
totalReservedQuantity开始配送。正在包装,运输等动态状态的货数
pendingCustomerOrderQuantity为客户订单保留的货品数
pendingTransshipmentQuantity从亚马逊库存转移到另一个亚马逊库存的货品数
fcProcessingQuantity被亚马逊物流搁置以进行其他处理的货品数
totalResearchingQuantity放错位置或损坏的货品总数
researchingQuantityBreakdown正在判断是否放错位置或损坏的货品总数和货品名称
totalUnfulfillableQuantity库存中不可售的货品数
customerDamagedQuantity客户损坏的货品数
warehouseDamagedQuantity损坏的货品总数
distributorDamagedQuantity亚马逊配送途中损坏的货品数
carrierDamagedQuantity承运人损坏的货品数
defectiveQuantity正在处理的损坏的货品数
expiredQuantity已过期的货品数
后续未完内容请尽情期待~



这篇关于Amazon SP-API文档看着累?那就看这里!的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/310774

相关文章

使用C#代码在PDF文档中添加、删除和替换图片

《使用C#代码在PDF文档中添加、删除和替换图片》在当今数字化文档处理场景中,动态操作PDF文档中的图像已成为企业级应用开发的核心需求之一,本文将介绍如何在.NET平台使用C#代码在PDF文档中添加、... 目录引言用C#添加图片到PDF文档用C#删除PDF文档中的图片用C#替换PDF文档中的图片引言在当

详解C#如何提取PDF文档中的图片

《详解C#如何提取PDF文档中的图片》提取图片可以将这些图像资源进行单独保存,方便后续在不同的项目中使用,下面我们就来看看如何使用C#通过代码从PDF文档中提取图片吧... 当 PDF 文件中包含有价值的图片,如艺术画作、设计素材、报告图表等,提取图片可以将这些图像资源进行单独保存,方便后续在不同的项目中使

基于Flask框架添加多个AI模型的API并进行交互

《基于Flask框架添加多个AI模型的API并进行交互》:本文主要介绍如何基于Flask框架开发AI模型API管理系统,允许用户添加、删除不同AI模型的API密钥,感兴趣的可以了解下... 目录1. 概述2. 后端代码说明2.1 依赖库导入2.2 应用初始化2.3 API 存储字典2.4 路由函数2.5 应

Python实现合并与拆分多个PDF文档中的指定页

《Python实现合并与拆分多个PDF文档中的指定页》这篇文章主要为大家详细介绍了如何使用Python实现将多个PDF文档中的指定页合并生成新的PDF以及拆分PDF,感兴趣的小伙伴可以参考一下... 安装所需要的库pip install PyPDF2 -i https://pypi.tuna.tsingh

Python批量调整Word文档中的字体、段落间距及格式

《Python批量调整Word文档中的字体、段落间距及格式》这篇文章主要为大家详细介绍了如何使用Python的docx库来批量处理Word文档,包括设置首行缩进、字体、字号、行间距、段落对齐方式等,需... 目录关键代码一级标题设置  正文设置完整代码运行结果最近关于批处理格式的问题我查了很多资料,但是都没

C#集成DeepSeek模型实现AI私有化的流程步骤(本地部署与API调用教程)

《C#集成DeepSeek模型实现AI私有化的流程步骤(本地部署与API调用教程)》本文主要介绍了C#集成DeepSeek模型实现AI私有化的方法,包括搭建基础环境,如安装Ollama和下载DeepS... 目录前言搭建基础环境1、安装 Ollama2、下载 DeepSeek R1 模型客户端 ChatBo

Python自动化Office文档处理全攻略

《Python自动化Office文档处理全攻略》在日常办公中,处理Word、Excel和PDF等Office文档是再常见不过的任务,手动操作这些文档不仅耗时耗力,还容易出错,幸运的是,Python提供... 目录一、自动化处理Word文档1. 安装python-docx库2. 读取Word文档内容3. 修改

Java调用DeepSeek API的最佳实践及详细代码示例

《Java调用DeepSeekAPI的最佳实践及详细代码示例》:本文主要介绍如何使用Java调用DeepSeekAPI,包括获取API密钥、添加HTTP客户端依赖、创建HTTP请求、处理响应、... 目录1. 获取API密钥2. 添加HTTP客户端依赖3. 创建HTTP请求4. 处理响应5. 错误处理6.

使用Python快速实现链接转word文档

《使用Python快速实现链接转word文档》这篇文章主要为大家详细介绍了如何使用Python快速实现链接转word文档功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 演示代码展示from newspaper import Articlefrom docx import

Deepseek R1模型本地化部署+API接口调用详细教程(释放AI生产力)

《DeepseekR1模型本地化部署+API接口调用详细教程(释放AI生产力)》本文介绍了本地部署DeepSeekR1模型和通过API调用将其集成到VSCode中的过程,作者详细步骤展示了如何下载和... 目录前言一、deepseek R1模型与chatGPT o1系列模型对比二、本地部署步骤1.安装oll