所有接口以 https://pic.waming.work/api.php 为入口，下文 Base URL 即 https://pic.waming.work。需要身份的操作，在请求头携带 Authorization: Bearer <令牌>；令牌在每次登录或重新生成后自动更换，旧令牌立即失效。

公开接口（无需令牌）

接口	说明
GET <?php echo site_url(); ?>/api.php/random	获取一张随机图片
GET /api.php/images	图片列表 sort=latest|hot|recommend|featured|follows · page · per_page · category=分类ID · search=关键词
GET /api.php/search?q=关键词	按名称/文件名搜索图片
GET /api.php/images/{id}/detail	图片详情（含介绍、作者、评论）
GET /api.php/categories	分类列表
GET /api.php/announcements	公告列表

需令牌接口（需携带 Bearer 令牌）

接口	说明
POST /api.php/upload	上传图片（multipart/form-data，见下方示例）
POST /api.php/images/{id}/like	点赞 / 取消点赞
POST /api.php/images/{id}/favorite	收藏 / 取消收藏
POST /api.php/images/{id}/comments	发表评论，正文 {content, reply_to?}（reply_to 为回复的评论ID）
GET /api.php/me/images	我的图片
GET /api.php/me/comments	我的评论
GET /api.php/me/favorites	我的收藏
GET /api.php/me/notifications	我的通知

上传接口示例（curl）

curl -X POST "https://pic.waming.work/api.php/upload" \
  -H "Authorization: Bearer <你的令牌>" \
  -F "files=@本地图片.png" \
  -F "name=图片标题" \
  -F "category=1" \
  -F "description=可选说明" \
  -F "watermark=1"

上传字段：files（文件，必填）、name（标题，必填）、category（分类ID，必填）、description（说明，可选）、watermark（传 1 添加右下角水印，可选）。支持 PNG / JPG / JPEG / GIF / WEBP / BMP，以文件头真实格式识别。

返回格式示例

{"images":[{"id":12,"custom_name":"图片标题","file_type":"PNG","file_size":"124.0 KB","group_key":"s12","is_multi":false,"uploader_name":"昵称",...}]}

错误时返回 {"error":"错误信息"}，配合 HTTP 状态码（400 参数错误 / 401 未登录 / 403 无权限 / 404 不存在）。