关于amazon:Amazon-SPAPI文档看着累那就看这里

咱们做跨境电商搞亚马逊API开发的都懂，首先就是文档的事件，亚马逊写的中文文档很坑啊有木有！！（原本英文文档就挺坑的了，小声BB～）

好了，就是要吐槽它一波～当初咱们进入正题～

咱们团队思考到很多做亚马逊API开发的敌人们，初期都要通过看文档这个干燥又乏味的过程，而后咱们寻思要不就写一篇API导航？我直呼好家伙，反应还挺大，毕竟这玩意写一次参考价值也是不菲的～

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

咱们就先将 Amazon SP-API references ⬅️ 这里的API它的用处剖析一遍（因为API比拟多，咱们明天先说一部分哦，谅解一下）

前情提要

以下所有API的申请门路全副以 Selling Partner API endpoints 结尾哦～

Selling Partner API endpoints ⬇️

Selling region	endpoint
北美地区（加拿大、美国、墨西哥、巴西）市场	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列表 ⬇️

申请办法	门路	参数	形容
GET	catalog/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的属性相干信息（只有品牌所有者能够应用此参数）

值	形容
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关联的供应商详细信息（只有供应商能够应用此参数）返回品牌, 类别, 产品组, 供应商代码等

名称	形容	概要
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/itemPreview	asin(必须的)program(必须的)marketplaceIds(可选的)	获取商品是否能够通过FBA入库的相干信息

各API申请参数：

GET /fba/inbound/v1/eligibility/itemPreview
参数：asin ➡️ 想要查问的ASIN
参数：Program ➡️ 传入查问应用的程序
参数：marketplaceIds ➡️ 市场ID，当program=INBOUND时必须传入
Program ⬇️
值形容
INBOUND 查看商品入库的程序
COMMINGLING 应用条形码进行物流跟踪的程序

值	形容
INBOUND	查看商品入库的程序
COMMINGLING	应用条形码进行物流跟踪的程序

各API响应参数：

Response /fba/inbound/v1/eligibility/itemPreview
名称形容概要
asin 查问的ASIN string
marketplaceId 要查问的市场 string
program 查问应用的程序 INBOUND, COMMINGLING
isEligibleForProgram 是否合乎FBA需要 boolean
ineligibilityReasonList 不合乎的起因返回起因的code

名称	形容	概要
asin	查问的ASIN	string
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/summaries	marketplaceIds(必须的)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
fnSku FBA的产品标签编码 string
sellerSku 商品的卖方SKU string
condition 卖方的商品形容。例：New Item string
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 已过期的货品数

名称	形容
fulfillableQuantity	可拣选，包装，运输的货品数
inboundWorkingQuantity	告诉亚马逊入库的货品数
inboundShippedQuantity	告诉亚马逊并有物流跟踪号的货品数
inboundReceivingQuantity	亚马逊物流未解决的入库货数
totalReservedQuantity	开始配送。正在包装，运输等动静状态的货数
pendingCustomerOrderQuantity	为客户订单保留的货品数
pendingTransshipmentQuantity	从亚马逊库存转移到另一个亚马逊库存的货品数
fcProcessingQuantity	被亚马逊物流搁置以进行其余解决的货品数
totalResearchingQuantity	放错地位或损坏的货品总数
researchingQuantityBreakdown	正在判断是否放错地位或损坏的货品总数和货品名称
totalUnfulfillableQuantity	库存中不可售的货品数
customerDamagedQuantity	客户损坏的货品数
warehouseDamagedQuantity	损坏的货品总数
distributorDamagedQuantity	亚马逊配送途中损坏的货品数
carrierDamagedQuantity	承运人损坏的货品数
defectiveQuantity	正在解决的损坏的货品数
expiredQuantity	已过期的货品数

前情提要

Selling Partner API for Catalog Items

API概览

API详情

Selling Partner API for FBA Inbound Eligibilty

API概览

API详情

Selling Partner API for FBA Inventory

API概览

API详情

后续未完内容请纵情期待~