添加图片

POST

/api/plugin/{pluginId}/images/create/

为插件添加展示图片。
注意：添加第一张图片时，会自动将其设为插件封面图（cover_url）。

请求体:
image_url (str, 必填) 图片 URL（来自文件上传 API）
title (str, 可选) 图片标题
sort_order (int, 可选) 排序权重，默认 0

错误码:
20030 插件不存在
20001 image_url 为空

使用示例 (curl):
curl -X POST http://127.0.0.1:8000/api/plugin/1/images/create/
-H "Content-Type: application/json"
-d '{"image_url":"/media/uploads/screenshot1.jpg","title":"首页截图"}'

请求参数

Path 参数

Body 参数application/json必填

示例

{}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "图片添加成功",
    "data": {
        "id": 1,
        "image_url": "/media/uploads/screenshot1.jpg",
        "title": "首页截图",
        "sort_order": 1
    }
}

修改于 2026-06-05 04:26:00

删除版本

删除图片