众泰云 API 接口文档 V7.0

API 基础地址：https://你的域名/ai-api.php

所有接口均通过 POST 或 GET 方式请求，返回 JSON 格式数据。字符编码统一为 UTF-8。

与 AI 客服进行智能对话。基于通义千问大模型，能解答企业服务问题、提供业务咨询、引导用户转化。

请求参数（JSON Body）

请求示例

{
  "message": "我想做一个企业官网，大概多少钱？",
  "history": [
    {"role": "user", "content": "你好"},
    {"role": "assistant", "content": "您好！我是小云，有什么可以帮助您的？"}
  ]
}

返回示例

// 成功
{
  "reply": "企业官网定制从¥3,000起，源码交付、独立部署..."
}

// 出错
{
  "error": "API调用失败"
}

获取所有已上架的商品/服务列表，支持分页和分类筛选。

请求参数

返回示例

{
  "success": true,
  "total": 38,
  "products": [
    {
      "id": 1,
      "slug": "tech-website",
      "name": "企业官网定制",
      "category": "技术搭建",
      "price": 3000.00,
      "image": "assets/uploads/xxx.jpg",
      "description": "...",
      "sales": 128
    }
  ]
}

根据商品唯一标识（slug）获取单个商品的完整信息，包含 SKU、规格等。

请求参数

返回示例

{
  "success": true,
  "product": {
    "id": 1,
    "slug": "tech-website",
    "name": "企业官网定制",
    "category": "技术搭建",
    "price": 3000.00,
    "image": "assets/uploads/xxx.jpg",
    "description": "...",
    "sales": 128,
    "skus": [
      {"spec_combination": "标准版", "price": 3000, "stock": 999}
    ],
    "specs": [
      {"spec_name": "版本", "spec_values": ["标准版","高级版","旗舰版"]}
    ]
  }
}

创建新的商品/服务。需要管理员或卖家认证。

请求参数（FormData）

返回示例

// 成功
{ "success": true, "product_id": 10 }

// 参数不全
{ "success": false, "error": "请填写商品名称和分类" }

// 未认证
{ "success": false, "error": "无权限" }

更新已有商品的信息。需要管理员或卖家认证。

请求参数（FormData）

返回示例

// 成功
{ "success": true }

// 商品不存在
{ "success": false, "error": "商品不存在" }

用户在前端提交服务订单或咨询需求，系统自动创建订单和咨询记录。

请求参数（FormData）

// 成功
{ "success": true, "message": "下单成功，我们将尽快联系您" }

// 参数不全
{ "success": false, "error": "请填写联系人和手机号" }

根据手机号查询历史订单，最多返回最近 20 条。

请求参数

返回示例

{
  "orders": [
    {
      "id": 1,
      "order_no": "ZT202606030001",
      "product_name": "企业官网定制",
      "amount": 5000.00,
      "status": "processing",
      "created_at": "2026-06-03 10:30:00"
    }
  ]
}

获取单个订单的完整信息。

请求参数

返回示例

{
  "success": true,
  "order": {
    "id": 1,
    "order_no": "ZT202606030001",
    "customer_name": "张三",
    "phone": "13800138000",
    "product_name": "企业官网定制",
    "amount": 5000.00,
    "status": "processing",
    "remark": "需要企业官网",
    "created_at": "2026-06-03 10:30:00"
  }
}

买家对某个服务向卖家发起咨询。

// 成功
{ "success": true }

// 参数不全
{ "success": false, "error": "参数不全" }

获取某个服务的买卖双方对话记录。

{
  "messages": [
    {
      "id": 1,
      "service": "咨询商品: 企业官网定制 - 能开发票吗？",
      "reply": "可以的。",
      "is_read": 1
    }
  ]
}

获取当前登录用户的基本信息。需要用户认证。

返回示例

{
  "success": true,
  "user": {
    "id": 1,
    "name": "张三",
    "phone": "138****8000",
    "avatar": "assets/uploads/avatars/xxx.jpg",
    "created_at": "2026-05-01"
  }
}

已登录用户上传个人头像。需要用户认证。

// 成功
{ "success": true }

// 未登录
{ "success": false, "error": "请先登录" }

// 文件过大
{ "success": false, "error": "图片不超过2MB" }

获取平台核心运营数据。需要管理员认证。

返回示例

{
  "success": true,
  "stats": {
    "month_revenue": 150000.00,
    "total_users": 1280,
    "total_orders": 356,
    "total_consults": 892,
    "pending_withdrawals": 5,
    "recent_orders": [...]
  }
}