1. 获取Token

功能 接口
请求方式 POST
URL http://imgurl.ps/api/token

请求参数

参数名称 类型 是否必须 说明
email String 邮箱
password String 账号密码

返回数据说明

参数名称 类型 实例值 说明
code Number 200 状态码,成功返回200,失败返回500
msg String success 提示信息
time Number 1544176295 响应时间戳
data array|object {"token": "8961576c9090ef0902c4b89406f8d557"} 获取的token数据

2. 图片上传

功能 接口
请求方式 POST
URL http://imgurl.ps/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": "http://域名/2018/12/08/5c0b519f44701.jpg"
}
图片数据

上传示例

POST /api/upload HTTP/1.1
Host: http://imgurl.ps
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

3. 获取图片列表

功能 接口
请求方式 POST
URL http://imgurl.ps/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:是)
upload_time Number 1572491936 图片上传时间
upload_date String 2019-10-31 11:18:56 图片上传日期
url String http://domain.com/2019/10/31/929616303ca92.jpg 图片链接

4. 获取单张图片

功能 接口
请求方式 POST
URL http://imgurl.ps/api/image

请求参数

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

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

5. 删除图片

功能 接口
请求方式 POST
URL http://imgurl.ps/api/delete

请求参数

参数名称 类型 是否必须 说明
id String 图片ID, 删除多个使用逗号分隔

6. 图片基本处理

模式 说明
/0/w/<LongEdge>/h/<ShortEdge> 限定缩略图的长边最多为<LongEdge>,短边最多为<ShortEdge>,进行等比缩放,不裁剪。如果只指定 w 参数则表示限定长边(短边自适应),只指定 h 参数则表示限定短边(长边自适应)。
/1/w/<Width>/h/<Height> 限定缩略图的宽最少为<Width>,高最少为<Height>,进行等比缩放,居中裁剪。转后的缩略图通常恰好是 <Width>x<Height> 的大小(有一个边缩放的时候会因为超出矩形框而被裁剪掉多余部分)。如果只指定 w 参数或只指定 h 参数,代表限定为长宽相等的正方图。
/2/w/<Width>/h/<Height> 限定缩略图的宽最多为<Width>,高最多为<Height>,进行等比缩放,不裁剪。如果只指定 w 参数则表示限定宽(高自适应),只指定 h 参数则表示限定高(宽自适应)。它和模式0类似,区别只是限定宽和高,不是限定长边和短边。从应用场景来说,模式0适合移动设备上做缩略图,模式2适合PC上做缩略图。
/3/w/<Width>/h/<Height> 限定缩略图的宽最少为<Width>,高最少为<Height>,进行等比缩放,不裁剪。如果只指定 w 参数或只指定 h 参数,代表长宽限定为同样的值。你可以理解为模式1是模式3的结果再做居中裁剪得到的。
/4/w/<LongEdge>/h/<ShortEdge> 限定缩略图的长边最少为<LongEdge>,短边最少为<ShortEdge>,进行等比缩放,不裁剪。如果只指定 w 参数或只指定 h 参数,表示长边短边限定为同样的值。这个模式很适合在手持设备做图片的全屏查看(把这里的长边短边分别设为手机屏幕的分辨率即可),生成的图片尺寸刚好充满整个屏幕(某一个边可能会超出屏幕)。
/5/w/<LongEdge>/h/<ShortEdge> 限定缩略图的长边最少为<LongEdge>,短边最少为<ShortEdge>,进行等比缩放,居中裁剪。如果只指定 w 参数或只指定 h 参数,表示长边短边限定为同样的值。同上模式4,但超出限定的矩形部分会被裁剪。
/format/<Format> 新图的输出格式
取值范围:jpggifpngwebp等,默认为原图格式。注:当原图为heic时,不指定输出格式,会输出jpg。
/interlace/<Interlace> 是否支持渐进显示
取值范围:1 支持渐进显示,0不支持渐进显示(默认为0)。
适用目标格式:jpg
效果:网速慢时,图片显示由模糊到清晰。
/colors/<colors> 源图片为 GIF 时,控制输出 GIF 中不同颜色的数量,取值可为2、4、8、16、32、64、128或256,不使用该参数时的默认值为128。
/q/<Quality> 新图的图片质量
取值范围是[1, 100],默认75。
接口会根据原图质量算出一个修正值,取修正值和指定值中的小值。
注意:
● 指定值后面可以增加 !,表示强制使用指定值,如100!
● 只支持原图类型:jpg。
/ignore-error/<ignoreError> 主要针对图片兼容性的问题导致无法处理,取值为1时,则处理失败时返回原图;
不设置此参数,默认处理失败时返回错误信息。

原图:https://xxx.imgurl.ps/2021/11/19/8514f5200c293.jpg

带参示例:https://xxx.imgurl.ps/2021/11/19/8514f5200c293.jpg?imageView2/1/w/200/h/200