API
ImgURL Pro API说明文档。
上传API
如果您还没有注册ImgURL免费图床,请先前往https://www.imgurl.org/vip/user#user=register 注册您的账号。
上传接口
- 接口地址:https://www.imgurl.org/api/v2/upload
- 请求类型:POST
注意:如果您的账号不是在imgurl.org注册,请改成对应服务商的域名。
请求参数
参数名 | 类型 | 是否必须 | 参数说明 |
---|---|---|---|
file | file | 是 | 支持jpg/jgeg/png/gif/bmp/webp格式 |
uid | string | 是 | 通过ImgURL后台获取 |
token | string | 是 | 通过ImgURL后台获取 |
album_id | int | 否 | 相册ID |
获取UID及Token
注册并登录ImgURL后,在用户后台 - 管理 - 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:\/\/imgurl.org\/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>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="https://www.imgurl.org/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>
获取相册列表
获取相册列表
- 接口地址:
/api/v2/albums
- 请求类型:GET/POST
- 数据类型:
form-data
注意:如果您的账号不是在imgurl.org注册,请改成对应服务商的域名。
请求参数
参数名 | 类型 | 是否必须 | 参数说明 |
---|---|---|---|
uid | string | 是 | 通过ImgURL后台获取 |
token | string | 是 | 通过ImgURL后台获取 |
请求成功
请求成功返回的JSON格式如下
{
"code": 200,
"msg": "",
"data": [
{
"album_id": "5",
"user_email": "xxx@qq.com",
"user_uid": "xxx",
"name": "大苏打1",
"description": "大苏打1",
"create_date": "2023-11-02 16:03:57",
"update_date": "2023-11-02 16:56:16",
"is_private": "1",
"password": null,
"cover": null
},
{
"album_id": "4",
"user_email": "xxx@qq.com",
"user_uid": "xxx",
"name": "你好啊",
"description": "你好啊",
"create_date": "2023-11-02 16:03:37",
"update_date": "2023-11-02 16:03:37",
"is_private": "1",
"password": null,
"cover": null
}
]
}
- code:状态码:200视为成功,其余为失败
- msg:错误消息,成功时为空,否则返回具体错误
- data.id:相册ID
- data.name:相册名称
请求失败
{
"code": -1000,
"msg": "您没有权限,请先登录!",
"data": ""
}