文件

优质

小牛编辑

134浏览

2023-12-01

上传检查

在上传一个文件前对文件进行检查，并创建一个 File with,如果文件存在，当文件存在，则创建一个 with id，不存在抛出 404。

GET /files/uploaded/:hash

Status: 200 OK

{
  "message": "获取成功",
  "id": 1
}

POST /files

名称	类型	描述
file	File	待上传的文件

Status: 201 Created

{
  "message": [
    "上传成功"
  ],
  "id": 1
}

GET /files/:file

这里的 :file 虽然叫做文件，实际是系统中的 file_with 标识，例如上传返回的都是 file_with 标识。

名称	类型	描述
w	float	需要获取的图片宽度，小数点后两位。
h	float	需要获取的图片高度，小数点后两位。
q	integer	可选，`1` <= `q` <= 100，可以和 `w`、`h` 配合使用，也可以单独使用，该参数表示图片质量
b	Integer	可选，范围 `0` - `100` ，表示需要高斯模糊的程度。
json	mixed	可选，不存在的情况下资源会使用 `302` 网络状态重定向到真实地址，如果存在则以 `json` 格式返回地址

q 参数在「本地 CDN 驱动」中，只针对 jpeg/jpg 图像有效，因为 png 未无损图像。 w & h 可以任意传一个，但是推荐都传递，只传一边的情况，则满足传递转换边，另一边按照图片比例自动设置。

Status: 200 OK

{
  "url": "https://www.xnip.cn/wp-content/uploads/2021/docimg15/29-a13gfet0gqz.png"
}

Status: 302 Found

不传递 w、h 的情况下，服务器会返回原是图片，如果传递，服务器则会拿出原始图像尺寸与获取尺寸进行计算，如果传递的获取最短边高于原图对应边，则直接返回原图，短于原图边的情况下取得获取边的最短边，并将对边使用原图尺寸自动设置尺寸。

在获取尺寸短于原图尺寸的情况下，处理后的图片永远只会满足获取遍的最低边，另一边自动尺寸，按照原图比例转换。

q 参数值针对 jpeg/jpg 有效，服务器会有修正值 90 高于 90 的质量处理都将按照 90 进行处理。