PRODUCT API V1
商品列表公开 API
外部项目可通过只读接口获取当前店铺的商品分类、商品名称、价格、库存、图片和购买链接。接口不会返回成本价、商户 Token、供货商标识或内部关联状态。
https://ld.mnqyi.com/open-api/v1
鉴权方式
接口已启用
所有请求必须携带服务端分配的 API Key：
X-API-Key: YOUR_API_KEY
不要把 API Key 写进公开网页前端。推荐由你的后端服务器调用本接口。浏览器跨域调用需要单独配置允许的 Origin。
默认限流为每个 API Key、每个客户端 IP 每分钟 60 次。响应头会返回 X-RateLimit-Limit 和 X-RateLimit-Remaining。
获取商品分类
GET
/open-api/v1/categoriescurl 'https://ld.mnqyi.com/open-api/v1/categories' \
-H 'X-API-Key: YOUR_API_KEY'
成功响应
{
"ok": true,
"categories": [
{"id": 75865, "name": "GEMINI", "sort": 1, "goods_count": 12}
],
"total": 1
}
获取商品列表
GET
/open-api/v1/products查询参数
| 参数 | 必填 | 说明 |
|---|---|---|
page | 否 | 页码，默认 1，范围 1–10000 |
page_size | 否 | 每页数量，默认 20，最大 50 |
keyword | 否 | 按商品名称或分类搜索，最多 120 字节 |
category_id | 否 | 分类 ID，0 或不传表示全部 |
goods_type | 否 | 商品类型，默认 card |
调用示例
curl
curl --get 'https://ld.mnqyi.com/open-api/v1/products' \
-H 'X-API-Key: YOUR_API_KEY' \
--data-urlencode 'keyword=plus' \
--data-urlencode 'page=1' \
--data-urlencode 'page_size=20'
JavaScript（Node.js）
const response = await fetch(
'https://ld.mnqyi.com/open-api/v1/products?page=1&page_size=20',
{ headers: { 'X-API-Key': process.env.PLUS123_API_KEY } }
);
const data = await response.json();
Python
import os
import requests
response = requests.get(
"https://ld.mnqyi.com/open-api/v1/products",
headers={"X-API-Key": os.environ["PLUS123_API_KEY"]},
params={"page": 1, "page_size": 20, "keyword": "plus"},
timeout=15,
)
response.raise_for_status()
data = response.json()
商品响应字段
| 字段 | 说明 |
|---|---|
id | 店铺商品 ID |
goods_key | 商品公开编号 |
name | 商品名称 |
price | 当前销售价 |
stock | 当前库存 |
status | 商品状态，列表只返回上架商品 |
description | 商品说明 |
image | 商品图片 URL |
link | 公开购买链接 |
category | 分类 ID 和名称 |
{
"ok": true,
"products": [{
"id": "1001",
"goods_key": "abc123",
"goods_type": "card",
"name": "Plus 商品",
"price": 19.9,
"stock": 20,
"status": 1,
"description": "商品说明",
"image": "https://qn.ldxp.cn/example.png",
"link": "https://wzyp.cn/item/abc123",
"category_id": 12,
"category": {"id": 12, "name": "GPT 服务"}
}],
"total": 1,
"page": 1,
"page_size": 20,
"total_pages": 1
}
错误处理
| HTTP | 错误码 | 说明 |
|---|---|---|
| 400 | invalid_page | 分页或查询参数不合法 |
| 401 | missing_api_key | 缺少 API Key |
| 401 | invalid_api_key | API Key 无效 |
| 429 | rate_limited | 超过每分钟调用限制 |
| 502 | upstream_error | 上游商品服务暂时不可用 |
| 503 | merchant_session_unavailable | 店铺登录态不可用 |
{
"ok": false,
"error": {
"code": "invalid_api_key",
"message": "API Key 无效"
}
}