上传API

如果您还没有注册远游图床免费图床，请先前往注册您的账号https://img.forwl.com/vip/user#user=register 。

上传接口

接口地址：https://www.img.forwl.com/api/v2/upload
请求类型：POST

请求参数

参数名	类型	是否必须	参数说明
file	file	是	支持jpg/jgeg/png/gif/bmp/webp格式
uid	string	是	通过远游图床后台获取
token	string	是	通过远游图床后台获取

获取UID及Token

注册并登录远游图床后，在用户后台 - 管理 - API Token查看您的UID 首次使用需要点击生成按钮以生成Token

请妥善保管您的Token，如果Token遭到泄露，可点击按钮更换。

返回值

如果请求成功，返回结果如下：

{
    "code": 200,
    "msg": "",
    "data":
    {
        "relative_path": "imgs\/2022\/03\/30\/f4a2eeb2689f9c19.jpg",
        "url": "https:\/\/s3.bmp.ovh\/imgs\/2022\/03\/30\/f4a2eeb2689f9c19.jpg",
        "thumbnail_url": "https:\/\/s3.bmp.ovh\/imgs\/2022\/03\/30\/f4a2eeb2689f9c19_thumb.jpg",
        "image_width": 1080,
        "image_height": 810,
        "client_name": "sanc1.jpg",
        "id": 1221739,
        "imgid": "f4a2eeb2689f9c19",
        "delete": "https:\/\/img.forwl.com\/delete\/649cbe0133f7ef95"
    }
}

参数名	类型	参数说明
code	int	状态码，200：成功，-1000：失败
msg	string	如果成功返回空，如果失败则返回错误信息
data	int	图像数据，各参数含义如下
data.relative_path	string	图片相对路径
data.url	string	图片URL地址
data.thumbnail_url	string	图片缩略图URL，如果没有生成缩略图，则和`data.url`地址相同
data.image_width	float	图片宽
data.image_height	int	图片高
data.client_name	string	图片原始名称
data.id	int	图片序号
data.imgid	string(16)	图片唯一ID
data.delete	string	图片删除地址，访问改地址图片将被删除

如果失败，返回结果为：

{
    "code": -1000,
    "msg": "上传失败，错误原因：The file you are attempting to upload is larger than the permitted size.",
    "data": ""
}

code: 状态码，失败时固定返回-1000
msg: 失败原因
data: 失败时固定返回空

演示代码

以下代码仅作为上传接口演示，正式环境中请勿使用，因为token信息明文保存在网页中，存在极大的安全风险。



    
    远游图床上传测试

通过PicGo上传

PicGo是一款跨平台图片上传客户端，支持Windows、Linux、MacOS操作系统，支持将图片上传到多个目标，比如远游图床、SM.MS等图床。

PicGo官网：https://picgo.github.io/PicGo

安装PicGo

前往Github：https://github.com/Molunerfinn/PicGo/releases 根据你的平台下载最新版本安装。
前往Node.js官网：https://nodejs.org/zh-cn/ 下载最新版Node.js安装（PicGo插件需要）
退出PicGo并重新打开，在插件设置中搜索“web-uploader”找到下面这个插件进行安装

获取远游图床 API

首先您需要在远游图床注册一个账号：远游图床
注册完毕并登录后在远游图床用户后台找到API地址/UID/Token三个参数并记录，稍后需要使用

设置PicGo

打开PicGo - 图床设置 - 自定义Web图床，填写上一步获取到的API信息，如下图。

API地址：填写远游图床的API地址，比如：http://img.forwl.com/api/v2/upload
POST参数名：填写file
JSON路径：填写data.url
自定义Body：填写下面的json

{"uid":"your uid","token":"your token"}

your uid：改成你在远游图床获取到的UID
your token：改成你在远游图床获取到的Token

然后点击确定进行保存，同时你也可以将其设置为默认图床。

上传图片

PicGo支持多种上传方式，比如快捷键上传、悬浮球上传、鼠标右键上传，下面分别介绍下不同上传方式。

快捷键上传：

你在本地选择一种图片，并按command + C后，再按command + Shift + P可以自动将选择的图片上传到PicGo，同时自动将URL链接放到剪贴板中。并且可以开启上传成功自动复制url。url也可以默认设置成Markdown格式，方便写笔记，非常方便。

悬浮球上传

点击PicGo界面上方LOGO，再点击图片即可上传。

七月

七月

远游图床API使用说明