cf_Ghbf

Appearance

存储渠道 ​

对象存储渠道的维护，业务表只保存相对路径。

存储渠道列表 ​

接口地址 ​

text
GET /admin/storage/list

接口参数说明 ​

无请求参数。

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": 1,
      "created_at": "2026-09-25T10:00:00+08:00",
      "updated_at": "2026-09-25T10:00:00+08:00",
      "name": "本地存储",
      "channel": "",
      "params": "{\"domain\":\"/files\"}",
      "is_default": 0,
      "status": 1,
      "sort": 0,
      "remark": ""
    }
  ]
}

响应参数说明 ​

成功时 data 为 null。

新增存储渠道 ​

接口地址 ​

text
POST /admin/storage/add

接口参数说明 ​

Body 参数类型必填说明
idinteger否主键ID，新增时不传
namestring是渠道名称
channelstring是渠道类型
paramsstring否渠道参数 JSON 字符串。
local:
alioss: {"bucket":"xxx","endpoint":"oss-cn-hangzhou.aliyuncs.com","access_key_id":"...","access_key_secret":"...","domain":"https://cdn.example.com"}
cos:
qiniu: {"bucket":"xxx","access_key":"...","secret_key":"...","domain":"https://cdn.example.com"}（domain 必填）
minio:
is_defaultinteger否是否默认 0否 1是
statusinteger否状态 1启用 2禁用
sortinteger否排序
remarkstring否备注

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1,
    "created_at": "2026-09-25T10:00:00+08:00",
    "updated_at": "2026-09-25T10:00:00+08:00",
    "name": "本地存储",
    "channel": "",
    "params": "{\"domain\":\"/files\"}",
    "is_default": 0,
    "status": 1,
    "sort": 0,
    "remark": ""
  }
}

响应参数说明 ​

响应字段类型说明
idinteger主键ID
created_atstring创建时间
updated_atstring更新时间
namestring渠道名称
channelstring渠道类型 local/alioss/cos/qiniu/minio
paramsstring渠道参数 JSON 字符串
is_defaultinteger是否默认 0否 1是
statusinteger状态 1启用 2禁用
sortinteger排序
remarkstring备注

修改存储渠道 ​

接口地址 ​

text
POST /admin/storage/update

接口参数说明 ​

Body 参数类型必填说明
idinteger否主键ID，新增时不传
namestring是渠道名称
channelstring是渠道类型
paramsstring否渠道参数 JSON 字符串。
local:
alioss: {"bucket":"xxx","endpoint":"oss-cn-hangzhou.aliyuncs.com","access_key_id":"...","access_key_secret":"...","domain":"https://cdn.example.com"}
cos:
qiniu: {"bucket":"xxx","access_key":"...","secret_key":"...","domain":"https://cdn.example.com"}（domain 必填）
minio:
is_defaultinteger否是否默认 0否 1是
statusinteger否状态 1启用 2禁用
sortinteger否排序
remarkstring否备注

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1,
    "created_at": "2026-09-25T10:00:00+08:00",
    "updated_at": "2026-09-25T10:00:00+08:00",
    "name": "本地存储",
    "channel": "",
    "params": "{\"domain\":\"/files\"}",
    "is_default": 0,
    "status": 1,
    "sort": 0,
    "remark": ""
  }
}

响应参数说明 ​

响应字段类型说明
idinteger主键ID
created_atstring创建时间
updated_atstring更新时间
namestring渠道名称
channelstring渠道类型 local/alioss/cos/qiniu/minio
paramsstring渠道参数 JSON 字符串
is_defaultinteger是否默认 0否 1是
statusinteger状态 1启用 2禁用
sortinteger排序
remarkstring备注

设为默认存储渠道 ​

接口地址 ​

text
POST /admin/storage/set_default

接口说明 ​

同一时间只允许存在一个未删除的默认渠道。

接口参数说明 ​

Body 参数类型必填说明
idinteger是主键ID

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "success",
    "data": null
  }
}

响应参数说明 ​

成功时 data 为 null。

删除存储渠道 ​

接口地址 ​

text
POST /admin/storage/delete

接口参数说明 ​

Body 参数类型必填说明
idinteger是主键ID

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "success",
    "data": null
  }
}

响应参数说明 ​

成功时 data 为 null。