Fecify-回收站-用户列表

接口信息

  • 接口地址: {your-site-url}/api/skill/account/soft-delete-list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 获取已软删除（回收站）的用户列表，支持分页和条件搜索。

认证

请求头中需要携带 skill-access-token：

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数

参数 类型 必填 说明
pageNum Number 否 当前页码，默认 1
pageSize Number 否 每页条数，默认 20
username String 否 用户账号，支持 LIKE 模糊搜索
deleted_at_begin String 否 软删除时间区间-开始时间，格式 YYYY-MM-DD HH:mm:ss
deleted_at_end String 否 软删除时间区间-结束时间

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/account/soft-delete-list?pageNum=1&pageSize=10&username=13156380573@163.com&deleted_at_begin=2022-07-01+00:00:00&deleted_at_end=2026-08-31+00:00:00' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 68,
                "username": "13156380573@163.com",
                "nickname": "",
                "deleted_at": "2023-07-10 11:09:04",
                "created_at": "2023-07-04 09:26:35",
                "avatar_img": "",
                "type": 2,
                "last_login_at": 0
            }
        ],
        "total": 1,
        "pageSize": 10,
        "totalPage": 1
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data Object 返回数据

data 子字段

字段 类型 说明
list Array 已软删除的用户列表
total Number 总记录数
pageSize Number 每页条数
totalPage Number 总页数

list 子项

字段 类型 说明
id Number 用户唯一 ID
username String 用户账号
nickname String 用户昵称
deleted_at String 软删除时间，格式 YYYY-MM-DD HH:mm:ss
created_at String 账号创建时间，格式 YYYY-MM-DD HH:mm:ss
avatar_img String 用户头像图片相对路径，完整 URL 需拼接 base_image_url（通过 Fecify-基本信息 获取）
type Number 账户类型：1 服务商后台开通的账户，2 商家端后台主账户（主操作员），3 商家端后台子账户（子操作员）
last_login_at Number / String 最后登录时间，0 表示从未登录

注意事项

  1. deleted_at_begin 和 deleted_at_end 是回收站列表特有的搜索参数，用于按删除时间筛选。
  2. 回收站列表返回的数据不包含 status 和 shops 字段。软删除的用户可通过 Fecify-回收站用户-恢复 恢复。

results matching ""

    No results matching ""