Base Image List API 文档

图片列表api

接口信息

接口地址: {your-site-url}/api/skill/base-image/get-image-list
基础 URL: {your-site-url} 需替换为你自己的 Fecmall 站点地址，如 https://your-domain.com/apimanager666
请求方式: GET
Content-Type: application/json

认证

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

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

请求参数 (Query String)

字段	类型	必填	说明
`pageNum`	int	选填	第几页，不填写则默认第 1 页
`pageSize`	int	选填	每页的数据个数，不填写则使用系统默认值
`group_type`	string	选填	图片分组，用于筛选指定类型的图片。可选值见下方枚举
`begin_at`	string	选填	图片创建时间-区间过滤-开始时间，格式如 `2025-05-01`
`end_at`	string	选填	图片创建时间-区间过滤-结束时间，格式如 `2026-05-29`

group_type 枚举值

值	说明
`product`	商品图片
`category`	商品专辑图片
`blog_article`	博客文章图片
`editor`	编辑器里面的图片
`common`	通用图片

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/base-image/get-image-list?pageNum=1&pageSize=10&group_type=product&begin_at=2025-05-01&end_at=2026-05-29' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

成功响应

{
    "code": 200,
    "data": {
        "upload_img_max_size": 40960,
        "upload_img_allow_types": [
            "image/gif",
            "image/jpeg",
            "image/png",
            "image/webp",
            "image/avif"
        ],
        "list": [
            {
                "id": 49846,
                "name": "a5f51aa28b9c58e7f9b1943b584b0883.png",
                "path": "/product/15/image/2026/05/05/a5f51aa28b9c58e7f9b1943b584b0883.png",
                "group_type": "product",
                "shop_id": 15,
                "width": 1200,
                "height": 468,
                "ratio": "2.56"
            }
        ],
        "total": 3353,
        "pageSize": 10,
        "totalPage": 336
    },
    "message": "success"
}

返回字段说明

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

data 顶层字段

字段	类型	说明
`upload_img_max_size`	Number	配置值：上传图片的最大尺寸（KB）
`upload_img_allow_types`	Array	配置值：支持的上传图片 MIME 类型
`list`	Array	图片列表
`total`	Number	所有数据的总行数
`pageSize`	Number	每页的数据个数
`totalPage`	Number	总页数

data.list 子项字段

字段	类型	说明
`id`	Number	图片 ID
`name`	String	图片名称（服务端存储的文件名）
`path`	String	图片存储路径
`group_type`	String	图片分组
`shop_id`	Number	店铺 ID
`width`	Number	图片宽度（像素）
`height`	Number	图片高度（像素）
`ratio`	String	图片宽高比，即 `width / height` 的计算值

注意事项

pageNum、pageSize、group_type、begin_at、end_at 均为选填参数
begin_at 和 end_at 配合使用可按图片创建时间进行区间过滤
group_type 必须从枚举值中选择
upload_img_max_size 和 upload_img_allow_types 为系统配置值，当前返回的是站点允许的上传限制

results matching ""

No results matching ""