远游图床API使用说明

 4个月前     125  

文章目录

上传API

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

上传接口

请求参数

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

获取UID及Token

注册并登录远游图床后,在用户后台 - 管理 - API Token查看您的UID

首次使用需要点击生成按钮以生成Token

远游图床API使用说明

请妥善保管您的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信息明文保存在网页中,存在极大的安全风险。

<!DOCTYPE html>
<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8" />
    <title>远游图床上传测试</title>
    <meta name="generator" content="EverEdit" />
    <meta name="author" content="" />
    <meta name="keywords" content="" />
    <meta name="description" content="" />
</head>
<body>
    <form enctype="multipart/form-data" method="post" action="https://img.forwl.com/api/v2/upload" id="upform">
    <input type="text" name="uid" value = "您的UID" hidden>
    <input type="text" name="token" value = "您的Token" hidden>
    <input type="file" name="file">
    <input type="submit" id="btn" value="开始上传" class="btn">
    </form>
</body>
</html>

通过PicGo上传

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

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

安装PicGo

  1. 前往Github:https://github.com/Molunerfinn/PicGo/releases 根据你的平台下载最新版本安装。
  2. 前往Node.js官网:https://nodejs.org/zh-cn/ 下载最新版Node.js安装(PicGo插件需要)
  3. 退出PicGo并重新打开,在插件设置中搜索“web-uploader”找到下面这个插件进行安装
  4. 远游图床API使用说明

获取远游图床 API

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

设置PicGo

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

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

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

  1. your uid:改成你在远游图床获取到的UID
  2. your token:改成你在远游图床获取到的Token

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

上传图片

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

快捷键上传:

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

悬浮球上传

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

远游图床API使用说明

 

版权声明:七月 发表于 4个月前,共 2749 字。
转载请注明:远游图床API使用说明 | 远游博客

暂无评论

暂无评论...