读取一个已上架商品的公开字段和可售规格,下架、删除或没有可售规格时返回 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"
    }
  ]
}