其它用法

这里的命令行使用和服务器使用等，均沿用了PicGo的使用方式，手册也是基于PicGo的手册进行修改的。

命令行上传

PicList支持命令行调用进行上传。

上传的命令是 upload （用于上传剪贴板图片）以及 upload xxx.jpg 用于上传具体路径的图片。

Windows

Windows可以通过 你安装的PicList的路径\PicList.exe upload 来调用上传。

macOS

macOS可以通过 /Applications/PicList.app/Contents/MacOS/PicList upload 来调用上传。

Linux

Linux可以通过 你安装的PicGo的路径/PicList.AppImage upload 来调用上传。

内置Server的使用

PicList内置了一个小型的服务器，用于接收来自其他应用或其他主机的HTTP请求来上传图片。

默认监听地址：0.0.0.0，默认监听端口：36677

接口鉴权

当将接口暴露于公网时，为了防止恶意上传，PicList提供了接口鉴权功能。

发送请求时添加URL查询参数key即可，例如：http://xxx:36677/upload?key=xxx。

表单上传 2.6.3+

• 请求方法: POST
• url: http://127.0.0.1:36677/upload （此处以默认配置为例）
• 请求body: multipart/form-data格式，key任选，value为图片文件

即可上传。

HTTP调用上传剪贴板图片

• 请求方法: POST
• url: http://127.0.0.1:36677/upload （此处以默认配置为例）
• 请求body: {list: ['xxx.jpg']} 必须是JSON格式

即可上传。

Tip

PicList支持通过设置picbed和configName两个URL查询参数来指定上传图床和配置文件。例如： http://127.0.0.1:36677/upload?picbed=aws-s3&configName=piclist-test 该配置将会使用aws-s3图床，并且使用piclist-test配置文件。

返回的数据：

{
  "success": true, // or false
  "result": ["url"]
}

HTTP调用上传具体路径图片

• method: POST
• url: http://127.0.0.1:36677/upload （此处以默认配置为例）
• request body: {list: ['xxx.jpg']} 必须是JSON格式

返回的数据：

{
  "success": true, // or false
  "result": ["url"]
}

HTTP调用删除图片

• method: POST
• url: http://127.0.0.1:36677/delete （此处以默认配置为例）
• request body: {list: [{xx:xx}]} 必须是JSON格式

list中的每一项都是一个对象，由上传接口返回数据的fullResult字段组成。

返回的数据：

{
  "success": true, // or false
  "message": xxx
}

heartbeat

• method: GET or POST
• url: http://127.0.0.1:36677/heartbeat （此处以默认配置为例）
• request body: {}

返回的数据：

{
  "success": true, // or false
  "result": "alive"
}

api文档

• method: GET
• url: http://127.0.0.1:36677 或 http://127.0.0.1:36677/upload

直接访问即可查看api文档。

内置文件Web服务器的使用

PicList支持通过内置的文件Web服务器来访问本地文件，可以在设置-高级设置-设置Web服务中开启和设置，功能类似EasyWebServer软件或python -m http.server命令。

默认监听地址：0.0.0.0，即本机的全部IP地址

默认监听端口：37777

默认监听地址：在Windows平台默认地址为C:\\Users，在macOS和Linux平台默认地址为根目录/。

在浏览器中输入http://127.0.0.1:37777即可访问并查看本地文件。

Tip

注意不能设置端口为36699，因为这个端口被PicList内置服务占用

PicList手机客户端联动

如果你想在手机上使用PicList类似的功能，可以安装我的另一个项目：PicHoro。

可以通过点击主窗口左下角信息栏按钮，找到「生成图床配置二维码」菜单

然后通过 PicHoro 的扫码功能，一键导入图床配置。