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

相关文章

Java调用DeepSeek API的最佳实践及详细代码示例

《Java调用DeepSeekAPI的最佳实践及详细代码示例》:本文主要介绍如何使用Java调用DeepSeekAPI,包括获取API密钥、添加HTTP客户端依赖、创建HTTP请求、处理响应、... 目录1. 获取API密钥2. 添加HTTP客户端依赖3. 创建HTTP请求4. 处理响应5. 错误处理6.

使用Python快速实现链接转word文档

《使用Python快速实现链接转word文档》这篇文章主要为大家详细介绍了如何使用Python快速实现链接转word文档功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 演示代码展示from newspaper import Articlefrom docx import

Deepseek R1模型本地化部署+API接口调用详细教程(释放AI生产力)

《DeepseekR1模型本地化部署+API接口调用详细教程(释放AI生产力)》本文介绍了本地部署DeepSeekR1模型和通过API调用将其集成到VSCode中的过程,作者详细步骤展示了如何下载和... 目录前言一、deepseek R1模型与chatGPT o1系列模型对比二、本地部署步骤1.安装oll

浅析如何使用Swagger生成带权限控制的API文档

《浅析如何使用Swagger生成带权限控制的API文档》当涉及到权限控制时,如何生成既安全又详细的API文档就成了一个关键问题,所以这篇文章小编就来和大家好好聊聊如何用Swagger来生成带有... 目录准备工作配置 Swagger权限控制给 API 加上权限注解查看文档注意事项在咱们的开发工作里,API

一分钟带你上手Python调用DeepSeek的API

《一分钟带你上手Python调用DeepSeek的API》最近DeepSeek非常火,作为一枚对前言技术非常关注的程序员来说,自然都想对接DeepSeek的API来体验一把,下面小编就来为大家介绍一下... 目录前言免费体验API-Key申请首次调用API基本概念最小单元推理模型智能体自定义界面总结前言最

JAVA调用Deepseek的api完成基本对话简单代码示例

《JAVA调用Deepseek的api完成基本对话简单代码示例》:本文主要介绍JAVA调用Deepseek的api完成基本对话的相关资料,文中详细讲解了如何获取DeepSeekAPI密钥、添加H... 获取API密钥首先,从DeepSeek平台获取API密钥,用于身份验证。添加HTTP客户端依赖使用Jav

C#使用DeepSeek API实现自然语言处理,文本分类和情感分析

《C#使用DeepSeekAPI实现自然语言处理,文本分类和情感分析》在C#中使用DeepSeekAPI可以实现多种功能,例如自然语言处理、文本分类、情感分析等,本文主要为大家介绍了具体实现步骤,... 目录准备工作文本生成文本分类问答系统代码生成翻译功能文本摘要文本校对图像描述生成总结在C#中使用Deep

5分钟获取deepseek api并搭建简易问答应用

《5分钟获取deepseekapi并搭建简易问答应用》本文主要介绍了5分钟获取deepseekapi并搭建简易问答应用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需... 目录1、获取api2、获取base_url和chat_model3、配置模型参数方法一:终端中临时将加

使用DeepSeek API 结合VSCode提升开发效率

《使用DeepSeekAPI结合VSCode提升开发效率》:本文主要介绍DeepSeekAPI与VisualStudioCode(VSCode)结合使用,以提升软件开发效率,具有一定的参考价值... 目录引言准备工作安装必要的 VSCode 扩展配置 DeepSeek API1. 创建 API 请求文件2.

使用SpringBoot创建一个RESTful API的详细步骤

《使用SpringBoot创建一个RESTfulAPI的详细步骤》使用Java的SpringBoot创建RESTfulAPI可以满足多种开发场景,它提供了快速开发、易于配置、可扩展、可维护的优点,尤... 目录一、创建 Spring Boot 项目二、创建控制器类(Controller Class)三、运行