获取产品SKU接口
获取指定产品的SKU(库存量单位)信息,包括产品的规格属性、价格、库存、批发规则等详细信息。此接口适用于需要展示产品详细规格和购买选项的场景。
注意事项
- 接口支持通过产品 ID 或 URL 别名(filename)两种方式获取产品SKU信息
- 此接口为产品接口,适用于产品类型文档
- 返回数据包含产品的完整规格信息和SKU列表
- 如果产品不存在,接口会返回错误码
请求地址
{域名地址}/api/archive/sku
说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/archive/sku
请求语法
GET {域名地址}/api/archive/sku?{参数}
请求头
此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
请求参数
| 字段名 |
类型 |
必填 |
说明 |
| id |
int |
是 |
文档 ID,如果传了 filename,可以不用传 ID |
| filename |
string |
否 |
文档 URL 别名,文档 ID、filename 二选一 |
响应头
此接口仅涉及公共相应头。更多信息,请参见公共请求头(Common Request Headers)。
返回参数
| 字段名 |
类型 |
说明 |
| code |
int |
错误码 |
| msg |
string |
错误原因说明 |
| data |
object |
结果内容 |
data 参数
| 字段名 |
类型 |
说明 |
| id |
int |
产品 ID |
| title |
string |
产品标题 |
| currency |
string |
货币名称 |
| curency_symbol |
string |
货币符号 |
| price |
float |
产品价格 |
| min_price |
float |
产品最低价格 |
| max_price |
float |
产品最高价格 |
| user_limit |
int |
用户限购数量 |
| quota_used |
int |
用户已购数量 |
| order_count |
int |
销量 |
| stock |
int |
库存数量 |
| options |
object[] |
产品规格属性名称 |
| skus |
object[] |
产品SKU信息 |
| wholesale_rules |
object[] |
产品批发规则 |
option 产品规格属性名称
| 字段名 |
类型 |
说明 |
| id |
int |
属性ID |
| title |
string |
属性名称 |
| values |
object[] |
属性 value 列表 |
属性 value
| 字段名 |
类型 |
说明 |
| id |
int |
分类 ID |
| option_id |
int |
属性 ID |
| option_title |
string |
属性名称 |
| images |
string[] |
图片列表 |
| title |
string |
属性 value 名称 |
| color |
string |
颜色值 |
| price |
float |
价格 |
sku 产品SKU信息
| 字段名 |
类型 |
说明 |
| id |
int |
分类 ID |
| title |
string |
sku 名称 |
| symbol |
string |
规格属性值id链接符号 |
| values |
object[] |
属性 value 列表 |
| sku |
string |
sku 链接符号 |
| barcode |
string |
条形码 |
| hs_code |
string |
海关编码 |
| images |
string[] |
图片列表 |
| logo |
string |
logo |
| thumb |
string |
缩略图 |
| stock |
int |
库存数量 |
| price |
int |
价格 |
| origin_price |
int |
原价 |
| weight |
int |
重量 |
| weight_unit |
string |
重量单位 |
| sold_count |
int |
销量 |
wholesale_rules 产品批发规则
| 字段名 |
类型 |
说明 |
| id |
int |
规则 ID |
| archive_id |
int |
文档 ID |
| min_quantity |
int |
最小数量 |
| max_quantity |
int |
最大数量 |
| sku_id |
int |
sku ID |
| discount_rate |
int |
折扣率, 0-100 |
| created_time |
int |
创建时间 |
| updated_time |
int |
更新时间 |
使用示例
请求示例
GET /api/archive/sku?id=1 HTTP/1.1
Host: your-domain.com
Content-Type: application/json
或
GET /api/archive/sku?filename=product-slug HTTP/1.1
Host: your-domain.com
Content-Type: application/json
响应示例
{
"code": 0,
"data": {
"id": 1,
"title": "示例产品",
"currency": "人民币",
"currency_symbol": "¥",
"price": 100.00,
"min_price": 80.00,
"max_price": 120.00,
"user_limit": 10,
"quota_used": 2,
"order_count": 100,
"stock": 998,
"options": [
{
"id": 1,
"title": "颜色",
"values": [
{
"id": 1,
"option_id": 1,
"option_title": "颜色",
"title": "红色",
"color": "#FF0000",
"price": 100.00
},
{
"id": 2,
"option_id": 1,
"option_title": "颜色",
"title": "蓝色",
"color": "#0000FF",
"price": 100.00
}
]
},
{
"id": 2,
"title": "尺寸",
"values": [
{
"id": 3,
"option_id": 2,
"option_title": "尺寸",
"title": "大号",
"color": "",
"price": 100.00
},
{
"id": 4,
"option_id": 2,
"option_title": "尺寸",
"title": "小号",
"color": "",
"price": 100.00
}
]
}
],
"skus": [
{
"id": 1,
"title": "红色-大号",
"symbol": "1-3",
"values": [
{
"id": 1,
"option_id": 1,
"option_title": "颜色",
"title": "红色",
"color": "#FF0000",
"price": 100.00
},
{
"id": 3,
"option_id": 2,
"option_title": "尺寸",
"title": "大号",
"color": "",
"price": 100.00
}
],
"sku": "SKU001",
"barcode": "123456789",
"hs_code": "",
"logo": "",
"thumb": "",
"stock": 100,
"price": 10000,
"origin_price": 12000,
"weight": 100,
"weight_unit": "g",
"sold_count": 50
}
],
"wholesale_rules": [
{
"id": 1,
"archive_id": 1,
"min_quantity": 1,
"max_quantity": 10,
"sku_id": 1,
"discount_rate": 90,
"created_time": 1630000000,
"updated_time": 1630000000
}
]
},
"msg": ""
}
错误代码
| 错误码 |
说明 |
| 0 |
OK |
| -1 |
错误,错误原因在 msg 中指出 |
| 1001 |
未登录 |
| 1002 |
未授权 |
| 200 |
API 请求 OK |