Fecify-激活店铺-列表

接口信息

  • 接口地址: {your-site-url}/api/skill/shop/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 否 每页条数，默认 10
name String 否 店铺名称，LIKE 模糊搜索
shop_type Number 否 店铺类型，通过 Fecify店铺类型列表 获取。仅 status=true 的类型可用
created_at_begin String 否 创建时间起始，格式 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss
created_at_end String 否 创建时间结束，格式 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss
status Number 否 店铺状态：1 = 激活，2 = 禁用
domain String 否 店铺域名，LIKE 模糊搜索

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/shop/list?pageNum=1&pageSize=10&name=3232&shop_type=10&created_at_begin=2023-03-02 00:00:00&created_at_end=2026-08-28 00:00:00&status=1' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 351,
                "name": "3232",
                "domain": "0d25398efc.fecmall.cn",
                "https": 1,
                "logo": "",
                "status": 1,
                "main_manager_id": 135,
                "created_at": "2026-07-20 23:11:25",
                "updated_at": "2026-07-20 23:11:25",
                "username": "shopb2b",
                "type": 10,
                "package_id": 11,
                "is_not_expire": 1,
                "expired_at": 1784560285,
                "package": {
                    "id": 11,
                    "title": "不可续费套餐",
                    "type": 1
                },
                "manager_url": "https://0d25398efc.fecmall.cn/apimanager666",
                "fornt_url": "https://0d25398efc.fecmall.cn"
            }
        ],
        "total": 1,
        "pageSize": 10,
        "totalPage": 1,
        "base_url": {
            "351": "https://0d25398efc.fecmall.cn/media"
        }
    },
    "message": "success"
}

返回字段说明

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

data 分页字段

字段 类型 说明
list Array 店铺记录列表
total Number 总记录数
pageSize Number 每页条数
totalPage Number 总页数
base_url Object 各店铺图片资源基础 URL，键为店铺 ID，值为该店铺的 media 根地址

list 子项

字段 类型 说明
id Number 店铺唯一 ID
name String 店铺名称
domain String 店铺域名
https Number HTTPS 证书：1 = 开启（HTTPS 访问），2 = 关闭（HTTP 访问）
logo String 店铺 Logo 图片路径
status Number 店铺状态：1 = 激活，2 = 禁用
main_manager_id Number 店铺主账号 ID
created_at String 店铺创建时间，格式 YYYY-MM-DD HH:mm:ss
updated_at String 店铺最后更新时间
username String / Null 店铺主账号用户名，无主账号时为 null
type Number 店铺类型：10 = B2C，20 = B2B。通过 Fecify店铺类型列表 获取详情
package_id Number 套餐 ID，0 表示未绑定套餐
is_not_expire Number 是否过期：1 = 未过期，2 = 已过期
expired_at Number 过期时间（Unix 时间戳）
package Object / Null 套餐信息，未绑定套餐时为 null
manager_url String 进入商家端后台的完整 URL
fornt_url String 进入前台商城的完整 URL

package 子字段

字段 类型 说明
id Number 套餐 ID
title String 套餐名称
type Number 套餐类型：1 = 常规套餐，2 = 体验套餐

注意事项

  1. shop_type 参数需从 Fecify店铺类型列表 中取 status=true 的类型 code 值。
  2. base_url 为各店铺图片资源的根地址，拼接图片路径后得到完整 URL。
  3. manager_url 可直接用于跳转进入该店铺的商家端后台。

results matching ""

    No results matching ""