Amazon Selling Partner API (SP-API)-中文
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
工具首页问答社区广告API开发者申请AI智能助手官方文档TokenApi Reference
  1. 工具首页
  • Auth Token
    • 获取Token
      POST
    • 刷新Token
      POST
    • 获取无授权Token
      POST
  • Api Reference
    • A+ Content Management
      • searchContentDocuments
      • createContentDocument
      • getContentDocument
      • updateContentDocument
      • listContentDocumentAsinRelations
      • postContentDocumentAsinRelations
      • validateContentDocumentAsinRelations
      • searchContentPublishRecords
      • postContentDocumentApprovalSubmission
      • postContentDocumentSuspendSubmission
    • Application Management
      • rotateApplicationClientSecret
    • AWD
      • getInboundShipment
      • listInboundShipments
      • listInventory
    • Catalog Items 2020-12-01
      • searchCatalogItems
      • getCatalogItem
    • Catalog Items 2022-04-01
      • searchCatalogItems
      • getCatalogItem
    • Data Kiosk
      • getQueries
      • createQuery
      • cancelQuery
      • getQuery
      • getDocument
    • Product Type Definitions
      • searchDefinitionsProductTypes
      • getDefinitionsProductType
    • Easy Ship
      • listHandoverSlots
      • getScheduledPackage
      • createScheduledPackage
      • updateScheduledPackages
      • createScheduledPackageBulk
    • FBA Inbound Eligibilty
      • getItemEligibilityPreview
    • FBA Inventory
      • getInventorySummaries
      • createInventoryItem
      • deleteInventoryItem
      • addInventory
    • Feeds 2020-09-04
      • getFeeds
      • createFeed
      • getFeed
      • cancelFeed
      • createFeedDocument
      • getFeedDocument
    • Feeds 2021-06-30
      • getFeeds
      • createFeed
      • cancelFeed
      • getFeed
      • createFeedDocument
      • getFeedDocument
    • Finances
      • listFinancialEventGroups
      • listFinancialEventsByGroupId
      • listFinancialEventsByOrderId
      • listFinancialEvents
    • Finances 2024-06-19
      • listTransactions
    • Fulfillment Inbound V0
      • createInboundShipmentPlan
      • createInboundShipment
      • updateInboundShipment
      • getPreorderInfo
      • confirmPreorder
      • getPrepInstructions
      • getTransportDetails
      • putTransportDetails
      • voidTransport
      • estimateTransport
      • confirmTransport
      • getLabels
      • getBillOfLading
      • getShipments
      • getShipmentItemsByShipmentId
      • getShipmentItems
    • FBA inbound operations. 2024-03-20
      • listInboundPlans
      • createInboundPlan
      • getInboundPlan
      • listInboundPlanBoxes
      • cancelInboundPlan
      • listInboundPlanItems
      • updateInboundPlanName
      • listPackingGroupBoxes
      • listPackingGroupItems
      • setPackingInformation
      • listPackingOptions
      • generatePackingOptions
      • confirmPackingOption
      • listInboundPlanPallets
      • listPlacementOptions
      • generatePlacementOptions
      • confirmPlacementOption
      • getShipment
      • listShipmentBoxes
      • listShipmentContentUpdatePreviews
      • generateShipmentContentUpdatePreviews
      • getShipmentContentUpdatePreview
      • confirmShipmentContentUpdatePreview
      • getDeliveryChallanDocument
      • listDeliveryWindowOptions
      • generateDeliveryWindowOptions
      • confirmDeliveryWindowOptions
      • listShipmentItems
      • updateShipmentName
      • listShipmentPallets
      • cancelSelfShipAppointment
      • getSelfShipAppointmentSlots
      • generateSelfShipAppointmentSlots
      • scheduleSelfShipAppointment
      • updateShipmentSourceAddress
      • updateShipmentTrackingDetails
      • listTransportationOptions
      • generateTransportationOptions
      • confirmTransportationOptions
      • listItemComplianceDetails
      • updateItemComplianceDetails
      • createMarketplaceItemLabels
      • getInboundOperationStatus
    • Fulfillment Outbound
      • getFulfillmentPreview
      • deliveryOffers
      • listAllFulfillmentOrders
      • createFulfillmentOrder
      • getPackageTrackingDetails
      • listReturnReasonCodes
      • createFulfillmentReturn
      • getFulfillmentOrder
      • updateFulfillmentOrder
      • cancelFulfillmentOrder
      • submitFulfillmentOrderStatusUpdate
      • getFeatures
      • getFeatureInventory
      • getFeatureSKU
    • Listings Items 2020-09-01
      • deleteListingsItem
      • patchListingsItem
      • putListingsItem
    • Listings Items 2021-08-01
      • searchListingsItems
      • deleteListingsItem
      • getListingsItem
      • patchListingsItem
      • putListingsItem
    • Listings Restrictions
      • getListingsRestrictions
    • Merchant Fulfillment
      • getEligibleShipmentServices
      • getShipment
      • cancelShipment
      • createShipment
      • getAdditionalSellerInputs
    • Messaging
      • getMessagingActionsForOrder
      • confirmCustomizationDetails
      • createConfirmDeliveryDetails
      • createLegalDisclosure
      • createNegativeFeedbackRemoval
      • createConfirmOrderDetails
      • createConfirmServiceDetails
      • CreateAmazonMotors
      • CreateWarranty
      • GetAttributes
      • createDigitalAccessKey
      • createUnexpectedProblem
      • sendInvoice
    • Notifications
      • getSubscription
      • createSubscription
      • getSubscriptionById
      • deleteSubscriptionById
      • getDestinations
      • createDestination
      • getDestination
      • deleteDestination
    • Orders
      • getOrders
      • getOrder
      • getOrderBuyerInfo
      • getOrderAddress
      • getOrderItems
      • getOrderItemsBuyerInfo
      • updateShipmentStatus
      • getOrderRegulatedInfo
      • updateVerificationStatus
      • confirmShipment
    • Product Fees
      • getMyFeesEstimateForSKU
      • getMyFeesEstimateForASIN
      • getMyFeesEstimates
    • Pricing V0
      • getPricing
      • getCompetitivePricing
      • getListingOffers
      • getItemOffers
      • getItemOffersBatch
      • getListingOffersBatch
    • Pricing 2022-05-01
      • getFeaturedOfferExpectedPriceBatch
      • getCompetitiveSummary
    • Replenishment
      • getSellingPartnerMetrics
      • listOfferMetrics
      • listOffers
    • Reports 2020-09-04
      • getReports
      • createReport
      • getReport
      • cancelReport
      • getReportSchedules
      • createReportSchedule
      • getReportSchedule
      • cancelReportSchedule
      • getReportDocument
    • Reports 2021-06-30
      • getReports
      • createReport
      • cancelReport
      • getReport
      • getReportSchedules
      • createReportSchedule
      • cancelReportSchedule
      • getReportSchedule
      • getReportDocument
    • Sales
      • getOrderMetrics
    • Sellers
      • getAccount
      • getMarketplaceParticipations
    • Services
      • getServiceJobByServiceJobId
      • cancelServiceJobByServiceJobId
      • completeServiceJobByServiceJobId
      • getServiceJobs
      • addAppointmentForServiceJobByServiceJobId
      • rescheduleAppointmentForServiceJobByServiceJobId
      • assignAppointmentResources
      • setAppointmentFulfillmentData
      • getRangeSlotCapacity
      • getFixedSlotCapacity
      • updateSchedule
      • createReservation
      • updateReservation
      • cancelReservation
      • getAppointmmentSlotsByJobId
      • getAppointmentSlots
      • createServiceDocumentUploadDestination
    • Shipment Invoicing
      • getShipmentDetails
      • submitInvoice
      • getInvoiceStatus
    • Shipping
      • createShipment
      • getShipment
      • cancelShipment
      • purchaseLabels
      • retrieveShippingLabel
      • purchaseShipment
      • getRates
      • getAccount
      • getTrackingInformation
    • Amazon Shipping API V2
      • getRates
      • directPurchaseShipment
      • purchaseShipment
      • oneClickShipment
      • getTracking
      • getShipmentDocuments
      • cancelShipment
      • getAdditionalInputs
      • getCarrierAccountFormInputs
      • getCarrierAccounts
      • linkCarrierAccount
      • unlinkCarrierAccount
      • generateCollectionForm
      • getCollectionFormHistory
      • getUnmanifestedShipments
      • getCollectionForm
      • getAccessPoints
    • Solicitations
      • getSolicitationActionsForOrder
      • createProductReviewAndSellerFeedbackSolicitation
    • Supply Sources
      • getSupplySources
      • createSupplySource
      • getSupplySource
      • updateSupplySource
      • archiveSupplySource
      • updateSupplySourceStatus
    • Invoices.
      • getInvoicesAttributes
      • getInvoicesDocument
      • createInvoicesExport
      • getInvoicesExports
      • getInvoicesExport
      • getInvoices
      • getInvoice
    • Tokens
      • createRestrictedDataToken
    • Automotive.
      • getVehicles
    • Uploads
      • createUploadDestinationForResource
    • third party application integrations.
      • createNotification
      • deleteNotifications
      • recordActionFeedback
    • Direct Fulfillment Inventory Updates
      • submitInventoryUpdate
    • Direct Fulfillment Orders V1
      • getOrders
      • getOrder
      • submitAcknowledgement
    • Direct Fulfillment Orders 2021-12-28
      • getOrders
      • getOrder
      • submitAcknowledgement
    • Direct Fulfillment Payments
      • submitInvoice
    • Vendor Direct Fulfillment Sandbox Test Data
      • generateOrderScenarios
      • getOrderScenarios
    • Direct Fulfillment Shipping V1
      • getShippingLabels
      • submitShippingLabelRequest
      • getShippingLabel
      • submitShipmentConfirmations
      • submitShipmentStatusUpdates
      • getCustomerInvoices
      • getCustomerInvoice
      • getPackingSlips
      • getPackingSlip
    • Direct Fulfillment Shipping 2021-12-28
      • getShippingLabels
      • submitShippingLabelRequest
      • getShippingLabel
      • createShippingLabels
      • submitShipmentConfirmations
      • submitShipmentStatusUpdates
      • getCustomerInvoices
      • getCustomerInvoice
      • getPackingSlips
      • getPackingSlip
    • Direct Fulfillment Transaction Status V1
      • getTransactionStatus
    • Direct Fulfillment Transaction Status 2021-12-28
      • getTransactionStatus
    • Retail Procurement Payments
      • submitInvoices
    • Retail Procurement Orders
      • getPurchaseOrders
      • getPurchaseOrder
      • submitAcknowledgement
      • getPurchaseOrdersStatus
    • Retail Procurement Shipments
      • SubmitShipmentConfirmations
      • SubmitShipments
      • GetShipmentDetails
    • Retail Procurement Transaction Status
      • getTransaction
    • Transfers. transfers_2024-06-01
      • initiatePayout
      • getPaymentMethods
  1. 工具首页

30秒调通SP-API接口?这个中文神器让Amazon开发不再踩坑

接口说明#

欢迎来到SP-API中文接口文档工作台。文档最新更新时间:2025年06月15日
这个工具不仅程序员能用,产品经理、测试人员、甚至对Amazon接口感兴趣的小白都能轻松上手。

SP-API中文工作台特点#

中文界面 - 终于不用对着英文文档发愁了
零基础友好 - 程序员、产品经理、测试、小白都能用
傻瓜式操作 - 市场ID都给你内置好了,美国市场直接输入{{US}}就行
自动化脚本 - 自动把token加入请求头,刷新token后自动更新到全局变量

三种情况,三种用法#

情况1:我已经有access_token了,就想赶紧测接口(30秒搞定)#

这是最爽的情况了。
方法一(推荐):一劳永逸设置
1.
点击任意接口旁边的"Run In Apifox"(不是在线调试!)
2.
在Apifox中打开后,找到全局变量设置
3.
把你的access_token贴进去,点保存
image.png
4.
选个环境(比如你要测美国站就选北美)
完事!之后API列表里的所有接口都自动带上你的token了,想测哪个点哪个。真的就30秒。
image.png
方法二:临时测试单个接口
如果你就想测一个接口,懒得设置全局变量,也行。记住先点"Run In Apifox",然后在Header里加个token参数,把你的access_token粘贴进去就行。
image.png
不过这样只对当前接口有效哈。

情况2:我有refresh_token,但access_token过期了(全自动刷新)#

这种情况特别常见,access_token才1小时就过期,烦死了。
好消息是,这个工具的自动化脚本帮你搞定了整个刷新流程:
1.
点"Run In Apifox"打开工具
2.
把你的refresh_token、client_id、client_secret填到全局变量里
image.png
3.
点一下"刷新Token"按钮
image.png
4.
等几秒钟,自动化脚本会:
调用刷新接口获取新token
自动把新token更新到全局变量
自动加入到所有请求的头部
然后你就可以愉快地测接口了,整个过程完全自动化,再也不用手动复制粘贴token。

情况3:我刚开始搞SP-API,啥token都没有(1分钟打通订单接口)#

这是最复杂的情况,但别慌,跟着做就行。即使是小白,也能1分钟内打通订单接口:
第一步:填基础信息(10秒)
点"Run In Apifox",把你的client_id和client_secret填到全局变量里。
image.png
第二步:搞OAuth授权(30秒)
这步有点麻烦,需要构造授权链接去浏览器授权。授权完了会跳转到一个回调地址,长这样:
授权详细过程可以参考视频教程:【Amazon SP-API 入门】第三节:发起第一个 API 调用,轻松上手接口请求工具!
https://api.sp-api.net/zh/?spapi_oauth_code=一串乱码&state=xxx&selling_partner_id=xxx
你要的是那个spapi_oauth_code后面的一串码,这就是授权码。
第三步:换取Token(20秒)
拿着授权码去调获取Token接口,请求体长这样:
{
    "grant_type": "authorization_code",
    "code": "刚才拿到的授权码",
    "client_id": "{{client_id}}",
    "client_secret": "{{client_secret}}"    
}
记得切换到Token接口环境,然后发送请求。成功了自动化脚本就会帮你把access_token保存到全局变量,并自动加入到所有请求头部。
现在你就能愉快地调用订单接口了!整个流程真的只要1分钟。
image.png

踩过的坑,顺便说说#

Token莫名其妙失效?
十有八九是过期了。SP-API的access_token只能用1小时,refresh_token能用1年。建议直接用情况2的方法自动刷新。
接口返回权限不足?
检查一下你选的环境对不对。测美国站的接口却选了欧洲环境,肯定不行。
OAuth授权老是失败?
回调URL配置可能有问题,或者你的应用还没通过审核。这个得去Amazon开发者后台检查。

写在最后#

说实话,SP-API的调试确实挺折腾的,特别是刚开始的时候。但有了这个中文工具,真的能省不少事。
我用了快一年了,基本上覆盖了所有的调试需求。最关键是:
自动化程度高 - token管理完全自动化,不用手工维护
适合所有人 - 不管你是程序员、产品经理还是测试,甚至小白都能快速上手
文档更新及时 - 不用担心接口变更了还在用老版本
30秒快速调试 - 有token的情况下真的就是秒级调通
1分钟完整流程 - 即使从零开始,1分钟也能打通订单接口
如果你也在搞SP-API开发,强烈建议试试这个工具。记住,一定要点"Run In Apifox",不要点在线调试,否则用不了这些自动化功能。
至少比纯手工用Postman调试要爽太多了!

相关搜索: Amazon SP-API 调试工具 | SP-API Postman教程 | 亚马逊API接口测试 | OAuth授权调试

技术咨询扫码联系作者

SP-API技术咨询,开发者申请,Amazon ERP源码

扫码加入交流群
修改于 2025-08-17 12:00:00
下一页
获取Token
Built with