我们做跨境电商搞亚马逊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的属性相关信息（只有品牌所有者可以使用此参数）
各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/itemPreview | asin(必须的)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 查询的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 已过期的货品数