Amazon SP-API文檔看着累？那就看這裏！

咱們作跨境電商搞亞馬遜API開發的都懂，首先就是文檔的事情，亞馬遜寫的中文文檔很坑啊有木有！！（原本英文文檔就挺坑的了，小聲BB～）

好了，就是要吐槽它一波～如今咱們進入正題～

咱們團隊考慮到不少作亞馬遜API開發的朋友們，初期都要通過看文檔這個枯燥又乏味的過程，而後咱們尋思要不就寫一篇API導航？我直呼好傢伙，反響還挺大，畢竟這玩意寫一次參考價值也是不菲的～

好了好了！不扯來扯去的了！想必大家都嫌我煩了！接下來咱們正式進入正題！！

咱們就先將 Amazon SP-API references ⬅️ 這裏的API它的用途分析一遍（因爲API比較多，咱們今天先說一部分哦，體諒一下）

前情提要

如下全部API的請求路徑所有以 Selling Partner API endpoints 開頭哦～

Selling Partner API endpoints ⬇️

Selling region	endpoint
北美地區（加拿大、美國、墨西哥、巴西）市場	sellingpartnerapi-na.amazon.com
歐洲地區（西班牙、英國、法國、德國、意大利、瑞典、波蘭、土耳其、阿聯酋、印度）市場	sellingpartnerapi-eu.amazon.com
遠東地區（新加坡、澳大利亞、日本）市場	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	已過時的貨品數

後續未完內容請盡情期待~

PS:你們看了後以爲對本身有幫助能夠三連留言,歡迎提出寶貴意見，如想進行技術交流歡迎加入Amazon各種API開發交流羣！請添加技術人員微信：x118422邀請進羣～