Skip to content

概述 ​

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


接入流程 ​

配置 AppId 与 AppSecret ​

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


获取访问 Token ​

  • 接口路径:POST /outapi/get_token
  • 请求类型:application/json
  • 请求参数:
参数名类型必填说明
appidstring是开放应用 AppID
appsecretstring是开放应用 AppSecret
  • 请求示例:
json
{
  "appid": "eb_open_1001",
  "appsecret": "c4ca4238a0b923820dcc509a6f75849b"
}
  • 返回结果:
json
{
  "status": 200,
  "msg": "获取成功",
  "data": {
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
    "exp": 86400
  }
}

业务接口调用方式 ​

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

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

示例:获取商品分类列表 ​

  • 请求路径:GET /outapi/product/category
  • 请求头:
    http
    Authori-zation: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOi...
  • 响应示例:
    json
    {
      "status": 200,
      "msg": "ok",
      "data": [
        {
          "id": 1,
          "cate_name": "手机数码",
          "pid": 0
        }
      ]
    }

开放接口清单一览 ​

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

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

安徽用易软件科技有限公司 · 承信租 V4 官方技术文档中心