概述

系统提供面向第三方系统对接的开放接口（outapi），支持商品同步、订单查询与更新、会员信息同步等能力。所有开放接口基于 app_id + app_secret 进行身份认证并换取 JWT Token。

---

接入流程

配置 AppId 与 AppSecret

在管理后台【设置 -> 接口管理 / 对外接口】中添加授权应用，获取系统分配的 app_id 与 app_secret，并设置接口访问权限。

---

获取访问 Token

• 接口路径：POST /outapi/get_token
• 请求类型：application/json
• 请求参数：

参数名	类型	必填	说明
appid	string	是	开放应用 AppID
appsecret	string	是	开放应用 AppSecret

• 请求示例：

{
  "appid": "eb_open_1001",
  "appsecret": "c4ca4238a0b923820dcc509a6f75849b"
}

• 返回结果：

{
  "status": 200,
  "msg": "获取成功",
  "data": {
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
    "exp": 86400
  }
}

---

业务接口调用方式

在请求需要授权的业务接口时，需在 HTTP 请求头中携带获取到的 Token：

Authori-zation: Bearer <获取到的token>

示例：获取商品分类列表

• 请求路径：GET /outapi/product/category
• 请求头：

  Authori-zation: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOi...

• 响应示例：

  {
    "status": 200,
    "msg": "ok",
    "data": [
      {
        "id": 1,
        "cate_name": "手机数码",
        "pid": 0
      }
    ]
  }

---

开放接口清单一览

路由配置文件：route/out.php

分组	接口路径	请求方式	说明
商品	/outapi/product/category	GET	获取商品分类列表
商品	/outapi/product/detail/:spu	GET	获取商品详情
商品	/outapi/product/set_show/:spu/:is_show	PUT	修改商品上下架状态
商品	/outapi/product/set_stock/:spu	POST	修改商品库存
订单	/outapi/order/list	GET	获取订单列表
订单	/outapi/order/detail/:oid	GET	获取订单详情
订单	/outapi/order/get_status/:oid	GET	查询订单状态
订单	/outapi/order/delivery_type/:oid	GET	查询配送物流信息
订单	/outapi/order/take_delivery/:oid	PUT	确认收货
订单	/outapi/order/refund/list	GET	查询售后退款订单
会员	/outapi/user/detail/:uid	GET	查询会员基本信息
会员	/outapi/user/address/:uid	GET	查询用户收货地址列表