跳转到主要内容

上传API

自ImgURL如果您还没有注册ImgURL免费图床，请先前往https://imgurl.org/vip/user#user=register Pro v1.1开始，支持token参数，token需要在后台生成（当传递token参数上传数量不受限制），如下图注册您的账号。

img

上传接口

请求参数

参数名 类型 是否必须 参数说明
file file 是 支持jpg/jgeg/png/gif/bmp/webp格式
uidstring是通过ImgURL后台获取
token string 否是 如果传递token则视为管理员上传通过ImgURL后台获取

获取UID及Token

注册并登录ImgURL后，在用户后台 - 管理 - API Token查看您的UID

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

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

返回值

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

{
    "code": 200,
    "id": 35,
	"imgid"msg": "ead2649f723a346c"",
    "data":
    {
        "relative_path": "imgs\/imgs/2019/10/ead2649f723a346c.png"2022\/03\/30\/f4a2eeb2689f9c19.jpg",
        "url": "http:https:\/\/pro.imgurl.org/imgs/2019/10/ead2649f723a346c.png"s3.bmp.ovh\/imgs\/2022\/03\/30\/f4a2eeb2689f9c19.jpg",
        "thumbnail_url": "http:https:\/\/pro.imgurl.org/imgs/2019/10/ead2649f723a346c_thumb.png"s3.bmp.ovh\/imgs\/2022\/03\/30\/f4a2eeb2689f9c19_thumb.jpg",
        "width"image_width": 1381,1080,
        "height"image_height": 645,810,
        "client_name": "sanc1.jpg",
        "id": 1221739,
        "imgid": "f4a2eeb2689f9c19",
        "delete": "http:https:\/\/pro.imgurl.org/delete/849a3ae44d87b641"org\/delete\/649cbe0133f7ef95"
    }
}
参数名 类型 参数说明
code int 状态码，200：成功，0：-1000：失败
idmsgstring如果成功返回空，如果失败则返回错误信息
data int id（唯一）图像数据，各参数含义如下
imgidstring图片id（唯一）
data.relative_path string 图片相对路径
data.url string 图片URLURL地址
data.thumbnail_url string 图片缩略图URLURL，如果没有生成缩略图，则和data.url地址相同
widthdata.image_width intfloat 图片宽
heightdata.image_height int 图片高
data.client_namestring图片原始名称
data.idint图片序号
data.imgidstring(16)图片唯一ID
data.delete string 图片删除链接地址，若此访问改地址图片之前已上传过，返回空将被删除

如果失败，返回结果为：

{
    "code":0, -1000,
    "msg": "上传失败，错误原因：The filetypefile you are attempting to upload is notlarger allowed.than the permitted size.",
    "data": ""
}
  • code: 状态码，200(成功),0(失败)时固定返回-1000
  • msg: 失败原因
  • data: 失败时固定返回空

演示代码

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

<!DOCTYPE html>
<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8" />
    <title>ImgURL上传测试</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="http://test.imgurl.org/api/upload" id="upform">
    <input type="file" name="file" class="up-file">
    <input type="submit" id="btn" value="开始上传" class="btn">
    </form>
</body>
</html>

探索发现

探索发现返回游客最新上传的图片，不显示管理员图片和可疑图片，说明如下。

  • 接口地址：http://new.imgurl.org/api/found
  • 返回数量：16

返回的结果如下：

[{
	"id": "15",
	"imgid": "9fde71fb50e4efe3",
	"path": "\/imgs\/2019\/04\/9fde71fb50e4efe3.png",
	"thumb_path": "\/imgs\/2019\/04\/9fde71fb50e4efe3_thumb.png",
	"date": "2019-04-10 16:41",
	"compression": "0",
	"level": "unknown",
	"mime": "image\/png",
	"width": "720",
	"height": "400",
	"views": "1",
	"ext": ".png",
	"client_name": "yz.png"
}, {
	"id": "14",
	"imgid": "e28dc32685726892",
	"path": "\/imgs\/2019\/04\/e28dc32685726892.png",
	"thumb_path": "\/imgs\/2019\/04\/e28dc32685726892_thumb.png",
	"date": "2019-04-10 16:37",
	"compression": "0",
	"level": "unknown",
	"mime": "image\/png",
	"width": "816",
	"height": "373",
	"views": "0",
	"ext": ".png",
	"client_name": "snipaste_20180908_164604.png"
}]

返回参数说明

  • id: id
  • imgid: 图片唯一id
  • path: 图片绝对路径
  • thumb_path: 缩略图绝对路径
  • date: 图片上传日期
  • compression: 图片是否压缩，0没有压缩，1已经压缩
  • level: 图片等级，unknown未知，adult成人图片,everyone正常
  • mime: 图片MIME类型
  • width: 图片宽
  • height: 图片高
  • views: 图片浏览次数
  • ext: 扩展名
  • client_name: 图片原始名字

其它参数

除了默认返回游客最新的16张图片外，还支持对图片进行筛选，比如gif动态图片，只需要在/api/found追加参数即可。

  • /api/found/gif: 返回gif动图
  • /api/found/view: 返回浏览次数最高的图片
  • /api/found/view: 返回高清大图，像素高于1920 * 1080
回到顶部