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操作PDF文档的主流库使用指南

《Python操作PDF文档的主流库使用指南》PDF因其跨平台、格式固定的特性成为文档交换的标准,然而,由于其复杂的内部结构,程序化操作PDF一直是个挑战,本文主要为大家整理了Python操作PD... 目录一、 基础操作1.PyPDF2 (及其继任者 pypdf)2.PyMuPDF / fitz3.Fre

SpringBoot监控API请求耗时的6中解决解决方案

《SpringBoot监控API请求耗时的6中解决解决方案》本文介绍SpringBoot中记录API请求耗时的6种方案,包括手动埋点、AOP切面、拦截器、Filter、事件监听、Micrometer+... 目录1. 简介2.实战案例2.1 手动记录2.2 自定义AOP记录2.3 拦截器技术2.4 使用Fi

springboot自定义注解RateLimiter限流注解技术文档详解

《springboot自定义注解RateLimiter限流注解技术文档详解》文章介绍了限流技术的概念、作用及实现方式,通过SpringAOP拦截方法、缓存存储计数器,结合注解、枚举、异常类等核心组件,... 目录什么是限流系统架构核心组件详解1. 限流注解 (@RateLimiter)2. 限流类型枚举 (

C#监听txt文档获取新数据方式

《C#监听txt文档获取新数据方式》文章介绍通过监听txt文件获取最新数据,并实现开机自启动、禁用窗口关闭按钮、阻止Ctrl+C中断及防止程序退出等功能,代码整合于主函数中,供参考学习... 目录前言一、监听txt文档增加数据二、其他功能1. 设置开机自启动2. 禁止控制台窗口关闭按钮3. 阻止Ctrl +

Java docx4j高效处理Word文档的实战指南

《Javadocx4j高效处理Word文档的实战指南》对于需要在Java应用程序中生成、修改或处理Word文档的开发者来说,docx4j是一个强大而专业的选择,下面我们就来看看docx4j的具体使用... 目录引言一、环境准备与基础配置1.1 Maven依赖配置1.2 初始化测试类二、增强版文档操作示例2.

Java操作Word文档的全面指南

《Java操作Word文档的全面指南》在Java开发中,操作Word文档是常见的业务需求,广泛应用于合同生成、报表输出、通知发布、法律文书生成、病历模板填写等场景,本文将全面介绍Java操作Word文... 目录简介段落页头与页脚页码表格图片批注文本框目录图表简介Word编程最重要的类是org.apach

Knife4j+Axios+Redis前后端分离架构下的 API 管理与会话方案(最新推荐)

《Knife4j+Axios+Redis前后端分离架构下的API管理与会话方案(最新推荐)》本文主要介绍了Swagger与Knife4j的配置要点、前后端对接方法以及分布式Session实现原理,... 目录一、Swagger 与 Knife4j 的深度理解及配置要点Knife4j 配置关键要点1.Spri

Python Pillow 库详解文档(最新推荐)

《PythonPillow库详解文档(最新推荐)》Pillow是Python中最流行的图像处理库,它是PythonImagingLibrary(PIL)的现代分支和继承者,本文给大家介绍Pytho... 目录python Pillow 库详解文档简介安装核心模块架构Image 模块 - 核心图像处理基本导入

HTML5 getUserMedia API网页录音实现指南示例小结

《HTML5getUserMediaAPI网页录音实现指南示例小结》本教程将指导你如何利用这一API,结合WebAudioAPI,实现网页录音功能,从获取音频流到处理和保存录音,整个过程将逐步... 目录1. html5 getUserMedia API简介1.1 API概念与历史1.2 功能与优势1.3

C#实现将Office文档(Word/Excel/PDF/PPT)转为Markdown格式

《C#实现将Office文档(Word/Excel/PDF/PPT)转为Markdown格式》Markdown凭借简洁的语法、优良的可读性,以及对版本控制系统的高度兼容性,逐渐成为最受欢迎的文档格式... 目录为什么要将文档转换为 Markdown 格式使用工具将 Word 文档转换为 Markdown(.