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

相关文章

使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

《使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)》PPT是一种高效的信息展示工具,广泛应用于教育、商务和设计等多个领域,PPT文档中常常包含丰富的图片内容,这些图片不仅提升了... 目录一、引言二、环境与工具三、python 提取PPT背景图片3.1 提取幻灯片背景图片3.2 提取

Android实现在线预览office文档的示例详解

《Android实现在线预览office文档的示例详解》在移动端展示在线Office文档(如Word、Excel、PPT)是一项常见需求,这篇文章为大家重点介绍了两种方案的实现方法,希望对大家有一定的... 目录一、项目概述二、相关技术知识三、实现思路3.1 方案一:WebView + Office Onl

Python实现word文档内容智能提取以及合成

《Python实现word文档内容智能提取以及合成》这篇文章主要为大家详细介绍了如何使用Python实现从10个左右的docx文档中抽取内容,再调整语言风格后生成新的文档,感兴趣的小伙伴可以了解一下... 目录核心思路技术路径实现步骤阶段一:准备工作阶段二:内容提取 (python 脚本)阶段三:语言风格调

使用Java将DOCX文档解析为Markdown文档的代码实现

《使用Java将DOCX文档解析为Markdown文档的代码实现》在现代文档处理中,Markdown(MD)因其简洁的语法和良好的可读性,逐渐成为开发者、技术写作者和内容创作者的首选格式,然而,许多文... 目录引言1. 工具和库介绍2. 安装依赖库3. 使用Apache POI解析DOCX文档4. 将解析

springboot项目中常用的工具类和api详解

《springboot项目中常用的工具类和api详解》在SpringBoot项目中,开发者通常会依赖一些工具类和API来简化开发、提高效率,以下是一些常用的工具类及其典型应用场景,涵盖Spring原生... 目录1. Spring Framework 自带工具类(1) StringUtils(2) Coll

Java利用docx4j+Freemarker生成word文档

《Java利用docx4j+Freemarker生成word文档》这篇文章主要为大家详细介绍了Java如何利用docx4j+Freemarker生成word文档,文中的示例代码讲解详细,感兴趣的小伙伴... 目录技术方案maven依赖创建模板文件实现代码技术方案Java 1.8 + docx4j + Fr

使用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