漫步图床

1. 图片上传

功能 接口
请求方式 POST
URL https://img.roamacg.com/api/upload

请求参数

参数名称 类型 是否必须 说明
image File 表单名称
注意:请求时header如果有参数 token,接口则认证该token,上传的图片也是在该token用户下,否则为游客上传。

返回数据说明

参数名称 类型 实例值 说明
code Number 200 状态码,成功返回200,失败返回500
msg String success 提示信息
time Number 1544176295 响应时间戳
data array|object
{
  "name": "9B7BCFBD05891B2D42187F126887777A.jpg",
  "url": "https://域名/item/5c0b519f44701.jpg"
}
获取的token数据

上传示例

POST /api/upload HTTP/1.1
Host: https://img.roamacg.com
Connection: keep-alive
Content-Length: 57398
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryx2mqINKHVPJ8yMdK

------WebKitFormBoundaryx2mqINKHVPJ8yMdK
Content-Disposition: form-data; name="image"; filename="test.png"
Content-Type: image/png

响应错误示例

{
  "code": 500,
  "msg": "管理员关闭了游客上传!",
  "data": null,
  "time": 1544245931
}
注意:以下接口均需要 Token

2. 获取图片列表

功能 接口
请求方式 POST
URL https://img.roamacg.com/api/images

请求参数

参数名称 类型 是否必须 说明
page String 页码
rows String 每页数量, 默认 20 条

返回数据(data)说明

参数名称 类型 实例值 说明
total Number 999 数据总量
per_page String 1 每页数量
current_page Number 1 当前所在页码
last_page Number 999 最后一页页码

图片数据说明

参数名称 类型 实例值 说明
id Number 1 图片ID
strategy String oss 储存策略, (cos:腾讯云, kodo:七牛云, local:本地, oss:阿里云oss, remote:远程储存, uss:又拍云)
path String 2019/10/31 图片所在路径
alias_name String test 图片别名
name String 929616303ca92.jpg 图片名称
pathname String 2019/10/31/929616303ca92.jpg 图片路径+名称
size String 30405.00 图片大小(字节: b)
mime String image/jpeg 图片 mime 类型
sha1 String 0143f7904f12e2a76ff2935f21a771b8adadf961 图片 sha1 值
md5 String e630c1d832f1701b0afe09cfe86a7f2b 图片 md5 值
ip String 192.168.0.1 上传者 IP
suspicious Number 0 是否是可疑图片, (0:否, 1:是)
update_time Number 1572491936 图片上传时间
update_date String 2019-10-31 11:18:56 图片上传日期
url String http://domain.com/item/929616303ca92.jpg 图片链接

3. 获取单张图片

功能 接口
请求方式 POST
URL https://img.roamacg.com/api/image

请求参数

参数名称 类型 是否必须 说明
id String 图片ID

返回数据(data)与第三条相同

4. 删除图片

功能 接口
请求方式 POST
URL https://img.roamacg.com/api/delete

请求参数

参数名称 类型 是否必须 说明
name String 图片名称, 使用数组形式