读取一个已上架商品的公开字段和可售规格,下架、删除或没有可售规格时返回 404
GET/api/v1/products/{id}
| 认证 | 不需要登录 |
|---|---|
| 权限 | 无 |
路径参数
path
idstring必填商品 ID
路径示例
/api/v1/products/prd_example响应
200
application/json
成功时 code 为 200,资源在 data
idstring必填商品 ID,以 prd_ 开头
catalog_idstring必填目录 ID
titlestring必填商品名称
coverstring | null必填封面地址,没有时为 null
currencystring必填货币代码
offer.priceinteger必填展示价,整数分
offer.currencystring必填展示价货币
offer.availabilityenum<string>必填商品可售状态
可选值: in_stockout_of_stock
fieldsobject必填公开字段,键是字段 key
variantsobject[]必填可售规格
variants[].idstring必填规格 ID,下单时作为 variant_id
variants[].priceinteger必填整数分
variants[].currencystring必填货币代码
variants[].stockinteger | null必填库存,null 表示不限
variants[].availabilityenum<string>必填可售状态
可选值: in_stockout_of_stock
variants[].option_valuesobject必填规格轴取值,键是轴 key
variants[].skustring | null必填SKU,没有时为 null
响应示例
{
"id": "prd_example",
"catalog_id": "cat_example",
"title": "示例",
"cover": "string",
"currency": "CNY",
"offer": {
"price": 159900,
"currency": "CNY",
"availability": "in_stock"
},
"fields": {},
"variants": [
{
"id": "var_example",
"price": 159900,
"currency": "CNY",
"stock": null,
"availability": "in_stock",
"option_values": {},
"sku": "string"
}
]
}