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文档》这篇文章主要为大家详细介绍了如何使用C#实现一键批量合并PDF文档功能,文中的示例代码简洁易懂,感兴趣的小伙伴可以跟随小编一起学习一下... 目录前言效果展示功能实现1、添加文件2、文件分组(书签)3、定义页码范围4、自定义显示5、定义页面尺寸6、PDF批量合并7、其他方法

PHP应用中处理限流和API节流的最佳实践

《PHP应用中处理限流和API节流的最佳实践》限流和API节流对于确保Web应用程序的可靠性、安全性和可扩展性至关重要,本文将详细介绍PHP应用中处理限流和API节流的最佳实践,下面就来和小编一起学习... 目录限流的重要性在 php 中实施限流的最佳实践使用集中式存储进行状态管理(如 Redis)采用滑动

Java实现在Word文档中添加文本水印和图片水印的操作指南

《Java实现在Word文档中添加文本水印和图片水印的操作指南》在当今数字时代,文档的自动化处理与安全防护变得尤为重要,无论是为了保护版权、推广品牌,还是为了在文档中加入特定的标识,为Word文档添加... 目录引言Spire.Doc for Java:高效Word文档处理的利器代码实战:使用Java为Wo

使用Python实现Word文档的自动化对比方案

《使用Python实现Word文档的自动化对比方案》我们经常需要比较两个Word文档的版本差异,无论是合同修订、论文修改还是代码文档更新,人工比对不仅效率低下,还容易遗漏关键改动,下面通过一个实际案例... 目录引言一、使用python-docx库解析文档结构二、使用difflib进行差异比对三、高级对比方

Python自动化处理PDF文档的操作完整指南

《Python自动化处理PDF文档的操作完整指南》在办公自动化中,PDF文档处理是一项常见需求,本文将介绍如何使用Python实现PDF文档的自动化处理,感兴趣的小伙伴可以跟随小编一起学习一下... 目录使用pymupdf读写PDF文件基本概念安装pymupdf提取文本内容提取图像添加水印使用pdfplum

Python从Word文档中提取图片并生成PPT的操作代码

《Python从Word文档中提取图片并生成PPT的操作代码》在日常办公场景中,我们经常需要从Word文档中提取图片,并将这些图片整理到PowerPoint幻灯片中,手动完成这一任务既耗时又容易出错,... 目录引言背景与需求解决方案概述代码解析代码核心逻辑说明总结引言在日常办公场景中,我们经常需要从 W

C#高效实现Word文档内容查找与替换的6种方法

《C#高效实现Word文档内容查找与替换的6种方法》在日常文档处理工作中,尤其是面对大型Word文档时,手动查找、替换文本往往既耗时又容易出错,本文整理了C#查找与替换Word内容的6种方法,大家可以... 目录环境准备方法一:查找文本并替换为新文本方法二:使用正则表达式查找并替换文本方法三:将文本替换为图

Python批量替换多个Word文档的多个关键字的方法

《Python批量替换多个Word文档的多个关键字的方法》有时,我们手头上有多个Excel或者Word文件,但是领导突然要求对某几个术语进行批量的修改,你是不是有要崩溃的感觉,所以本文给大家介绍了Py... 目录工具准备先梳理一下思路神奇代码来啦!代码详解激动人心的测试结语嘿,各位小伙伴们,大家好!有没有想

Go语言使用net/http构建一个RESTful API的示例代码

《Go语言使用net/http构建一个RESTfulAPI的示例代码》Go的标准库net/http提供了构建Web服务所需的强大功能,虽然众多第三方框架(如Gin、Echo)已经封装了很多功能,但... 目录引言一、什么是 RESTful API?二、实战目标:用户信息管理 API三、代码实现1. 用户数据

Python用Flask封装API及调用详解

《Python用Flask封装API及调用详解》本文介绍Flask的优势(轻量、灵活、易扩展),对比GET/POST表单/JSON请求方式,涵盖错误处理、开发建议及生产环境部署注意事项... 目录一、Flask的优势一、基础设置二、GET请求方式服务端代码客户端调用三、POST表单方式服务端代码客户端调用四