API

ImgURL Pro API说明文档。

上传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": ""
}