Open Platform
开放平台
面向开发者与集成方：申请 API Key、查看示例代码与 Open API 清单
开放平台价值
以统一 Open API 承接 Agent 与业务系统，与 OCP、数据服务及 Skill 生态对齐
主要用户
- ISV / 系统集成商
- 品牌与零售技术
- 独立开发者与 Agent
API Key 申请
请填写申请表单；我们将在3个工作日内完成审核，并通过邮件发送 x-app-key 及环境说明
入参、出参字段以完整 Open API 文档为准。通用请求头：x-app-key（必填）；POST/PATCH/DELETE 带 body 时 Content-Type: application/json。
商品检索与详情
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /open/products/search | 关键词等条件分页检索商品列表 |
| GET | /open/products/{productId} | SPU 详情（SKU、报价、推广链接等） |
开放管理 — 商品
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /open/manage/products | 管理侧商品列表（q、类目、分页） |
| GET | /open/manage/products/{productId} | 管理侧单条商品详情 |
| POST | /open/manage/products | 创建商品（title、imageUrl 等） |
| PATCH | /open/manage/products/{productId} | 部分字段更新 |
| DELETE | /open/manage/products/{productId} | 删除商品 |
开放管理 — 类目
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /open/manage/categories | 类目树 |
| POST | /open/manage/categories | 新建类目 |
| PATCH | /open/manage/categories/{categoryId} | 更新类目 |
| DELETE | /open/manage/categories | 批量删除（body 含 ids） |
MiniShop
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /open/minishops/catalog | 商城目录（商家、类目、商品卡片） |
| GET | /open/minishops/products/{productId} | 商城单品详情 |
| GET | /open/minishops/cart | 当前购物车 |
| DELETE | /open/minishops/cart | 清空购物车 |
| POST | /open/minishops/cart/items | 加入购物车（productId、qty） |
| PATCH | /open/minishops/cart/items/{productId} | 修改行数量 |
| DELETE | /open/minishops/cart/items/{productId} | 删除购物车一行 |
| POST | /open/minishops/pay/prepare | 下单预支付（表单跳转网关） |
| GET | /open/minishops/pay/status | 查询支付状态（out_trade_no） |
自有供应链
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /open/manage/self-supply/merchants | 入驻商家列表（可选 q） |
| POST | /open/manage/self-supply/merchants | 新建店铺（shopName、可选 shopSlug） |
| PATCH | /open/manage/self-supply/merchants/{merchantId} | 修改商家入驻信息（店铺名、域名、联系人等） |
| DELETE | /open/manage/self-supply/merchants/{merchantId} | 删除店铺（需 body.confirm=DELETE_SHOP） |
| POST | /open/manage/self-supply/merchants/{merchantId}/one-click-open | 一键开店 |
| GET | /open/manage/self-supply/products | 自有供应链商品草稿列表 |
| GET | /open/manage/self-supply/product-categories | 可选类目列表（q 搜索，供发布选类） |
| POST | /open/manage/self-supply/products | 新建草稿（类目须为标准路径或 id） |
| PATCH | /open/manage/self-supply/products/{productId} | 修改草稿（类目须合法） |
| DELETE | /open/manage/self-supply/products/{productId} | 删除商品（需 confirm=DELETE_PRODUCT） |
| POST | /open/manage/self-supply/products/{productId}/one-click-publish | 一键发布到 MiniShop |
当前账户
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /open/access-clients/me | 当前 appKey 对应客户端信息与调用量等 |
接口测试
通过本站代理转发到您填写的 API 根地址（避免浏览器跨域）。生产环境请在服务器配置 OPEN_API_TRY_HOSTS 白名单主机。
Query 提示：（请求体检索，无 query）
POST /open/products/search
开发者代码示例
以下示例以只读列表接口为例（GET /open/manage/products）；其他路径请替换 URL 与请求方法。
import urllib.request
import json
BASE = "https://jiesuoai.com" # 网关基座
APP_KEY = "YOUR_APP_KEY" # 审核通过后下发
url = BASE + "/open/manage/products?page=1&pageSize=10"
req = urllib.request.Request(
url,
headers={"x-app-key": APP_KEY, "Accept": "application/json"},
method="GET",
)
with urllib.request.urlopen(req, timeout=30) as resp:
data = json.loads(resp.read().decode())
print(json.dumps(data, indent=2, ensure_ascii=False))
请将 YOUR_APP_KEY 替换为审核通过后的密钥；示例请求发往 jiesuoai.com 网关基座。