- Auth Token
- Api Reference
- Orders
- Reports 2021-06-30
- Feeds 2020-09-04
- Sellers
- Pricing 2022-05-01
- Notifications
- A+ Content Management
- Application Management
- The AWD
- Catalog Items V0
- Catalog Items 2020-12-01
- Catalog Items 2022-04-01
- Data Kiosk
- Product Type Definitions
- Automotive.
- Easy Ship
- FBA Inbound Eligibilty
- FBA Inventory
- Finances
- Finances 2024-06-19
- Fulfillment Inbound V0
- Listings Items 2021-08-01
- Listings Restrictions
- Merchant Fulfillment
- Messaging
- Product Fees
- Pricing V0
- Replenishment
- Sales
- Services
- getServiceJobByServiceJobId
- cancelServiceJobByServiceJobId
- completeServiceJobByServiceJobId
- getServiceJobs
- addAppointmentForServiceJobByServiceJobId
- rescheduleAppointmentForServiceJobByServiceJobId
- assignAppointmentResources
- setAppointmentFulfillmentData
- getRangeSlotCapacity
- getFixedSlotCapacity
- updateSchedule
- createReservation
- updateReservation
- cancelReservation
- getAppointmmentSlotsByJobId
- getAppointmentSlots
- createServiceDocumentUploadDestination
- Shipment Invoicing
- Shipping
- Amazon Shipping API V2
- getRates
- directPurchaseShipment
- purchaseShipment
- oneClickShipment
- getTracking
- getShipmentDocuments
- cancelShipment
- getAdditionalInputs
- getCarrierAccountFormInputs
- getCarrierAccounts
- linkCarrierAccount
- unlinkCarrierAccount
- generateCollectionForm
- getCollectionFormHistory
- getUnmanifestedShipments
- getCollectionForm
- getAccessPoints
- Solicitations
- Supply Sources
- Transfers. transfers_2024-06-01
- Tokens
- Uploads
- Invoices.
- 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
- Reports 2020-09-04
- Feeds 2021-06-30
- Listings Items 2020-09-01
- Application integrations.
- Direct Fulfillment Inventory Updates
- Direct Fulfillment Orders V1
- Direct Fulfillment Orders 2021-12-28
- Direct Fulfillment Payments
- Vendor Direct Fulfillment Sandbox Test Data
- Direct Fulfillment Shipping V1
- Direct Fulfillment Shipping 2021-12-28
- Direct Fulfillment Transaction Status V1
- Direct Fulfillment Transaction Status 2021-12-28
- Retail Procurement Payments
- Retail Procurement Orders
- Retail Procurement Shipments
- Retail Procurement Transaction Status
getListingsItem
北美(North America)
北美(North America)
GET
https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/{sellerId}/{sku}
Listings Items 2021-08-01
速率(每秒请求) | 暴发 |
---|---|
5 | 10 |
x-amzn-RateLimit-Limit
响应头返回请求操作应用的使用计划速率限制(如可用)。上表指示此操作的默认速率和暴发值。业务需求更高的销售伙伴可能会看到比这里所示更高的速率和暴发值。有关更多信息,请参阅销售伙伴API中的使用计划和速率限制。请求参数
Path 参数
sellerId
string
必需
sku
string
必需
Query 参数
marketplaceIds
array[string]
必需
<= 1 items
示例值:
ATVPDKIKX0DER
issueLocale
string
可选
en_US
、fr_CA
、fr_FR
。当指定区域设置中没有可用的本地化时,本地化消息默认为 en_US
。示例值:
en_US
includedData
array[string]
可选
summaries
。枚举值:
summariesattributesissuesoffersfulfillmentAvailabilityprocurementrelationshipsproductTypes
默认值:
summaries
示例值:
summaries
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items//?marketplaceIds=ATVPDKIKX0DER'
返回响应
🟢200成功。
application/json
Body
亚马逊目录中的一件商品。
description
string
交易中项目的描述
relatedIdentifiers
array[object (ItemRelatedIdentifier) {2}]
可选
itemRelatedIdentifierName
enum<string>
可选
枚举值:
ORDER_ADJUSTMENT_ITEM_IDCOUPON_IDREMOVAL_SHIPMENT_ITEM_IDTRANSACTION_ID
itemRelatedIdentifierValue
string
可选
totalAmount
object (Currency)
可选
currencyCode
string
可选
currencyAmount
number
可选
breakdowns
array[object (Breakdown) {3}]
可选
breakdownType
string
收费类型。
breakdownAmount
object (Currency)
可选
breakdowns
object (Breakdown)
可选
contexts
array[object (Context) {17}]
可选
contextType
string
必需
storeName
string
可选
orderType
string
交易的订单类型。
channel
string
可选
asin
string
可选
sku
string
可选
quantityShipped
integer <int32>
发货商品数量。
fulfillmentNetwork
string
该商品的履行网络。
paymentType
string
付款方式。
paymentMethod
string
付款方式已完成。
paymentReference
string
已支付的参考编号。
paymentDate
string <date-time>
Date
deferralReason
string
可选
maturityDate
string <date-time>
Date
deferralStatus
string
可选
startTime
string <date-time>
Date
endTime
string <date-time>
Date
示例
{
"sku": "GM-ZDPI-9B4E",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"asin": "B071VG5N9D",
"productType": "LUGGAGE",
"conditionType": "new_new",
"status": [
"BUYABLE"
],
"itemName": "Hardside Carry-On Spinner Suitcase Luggage",
"createdDate": "2021-02-01T00:00:00Z",
"lastUpdatedDate": "2021-03-01T00:00:00Z",
"mainImage": {
"link": "https://www.example.com/luggage.png",
"height": 500,
"width": 500
}
}
],
"offers": [
{
"marketplaceId": "ATVPDKIKX0DER",
"offerType": "B2C",
"price": {
"currencyCode": "USD",
"amount": "100.00"
},
"audience": {
"value": "ALL",
"displayName": "Sell on Amazon"
}
}
],
"fulfillmentAvailability": [
{
"fulfillmentChannelCode": "DEFAULT",
"quantity": 100
}
],
"issues": [
{
"code": "90220",
"message": "'size' is required but not supplied.",
"severity": "ERROR",
"attributeNames": [
"size"
],
"categories": [
"MISSING_ATTRIBUTE"
]
},
{
"code": "18027",
"message": "We believe the main image has text, logo, graphic or watermark which is not permitted for this product type. Please submit a compliant image to lift the suppression. Also refer to Product image requirements.",
"severity": "ERROR",
"categories": [
"INVALID_IMAGE"
],
"enforcements": {
"actions": [
{
"action": "SEARCH_SUPPRESSED"
}
],
"exemption": {
"status": "EXEMPT_UNTIL_EXPIRY_DATE",
"expiryDate": "2025-05-28T00:36:48.914Z"
}
}
},
{
"code": "99300",
"message": "Product Detail Page Rules Violation (Inaccurate information on product detail page)",
"severity": "ERROR",
"categories": [],
"enforcements": {
"actions": [
{
"action": "ATTRIBUTE_SUPPRESSED"
}
],
"exemption": {
"status": "EXEMPT"
}
}
},
{
"code": "18155",
"message": "The 'minimum price' is greater than the selling price (excluding shipping) for the listing. Please review and update your price and/or minimum price.",
"severity": "ERROR",
"categories": [
"INVALID_PRICE"
],
"enforcements": {
"actions": [
{
"action": "LISTING_SUPPRESSED"
}
],
"exemption": {
"status": "NOT_EXEMPT"
}
}
},
{
"code": "18742",
"message": "Restricted Products Policy Violation",
"severity": "ERROR",
"categories": [],
"enforcements": {
"actions": [
{
"action": "CATALOG_ITEM_REMOVED"
}
],
"exemption": {
"status": "NOT_EXEMPT"
}
}
}
]
}
🟠400请求缺少或无效的参数,无法解析。
🟠403表示禁止访问该资源。可能的原因包括访问被拒绝、未经授权、令牌过期或签名无效。
🟠404指定的资源不存在。
🟠413请求大小超过了最大接受大小。
🟠415请求负载格式不受支持。
🟠429请求的频率超过了允许的范围。
🔴500发生了意外情况,导致服务器无法完成请求。
🔴503服务器的临时超载或维护。

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


修改于 2025-04-26 10:49:42