图片上传

api/file/img-upload

请求说明

POST
开发中

请求参数

名称 类型 是否必须 示例值 描述
file 文件

文件(字段名其实随意的,但一次只能上传一张图片

dh 数字

当handler非空,用于指定处理后图片高度

dw 数字

当handler非空,用于指定处理后图片宽度

h 数字

当handler为crop(裁剪)时候,指定裁剪高度

handler 字符串

可用于图片处理。取值:resize(缩放),crop(裁剪)

w 数字

当handler为crop(裁剪)时候,指定裁剪宽度

x 数字

当handler为crop(裁剪)时候,指定裁剪起始x坐标

y 数字

当handler为crop(裁剪)时候,指定裁剪起始y坐标

响应参数

名称 类型 示例值 描述
raw_name String gbyp6

存储文件名

file_ext String .jpg

文件扩展名(直接获取客户端的扩展名)

file_type String image/jpeg

文件类型

file_size Int 7828

文件大小(单位:字节)

file_path String ./uploads/baike/2017/06/

相对路径

client_name String 2013031511172436.jpg

文件名(上传前的文件名)

is_image Bit 1

是否为图片(1:是;0:不是)

image_width Int 200

图片宽度

image_height Int 200

图片高度

upload_time Timestamp 1497249757

上传时间时间戳

user_id Int 10000

用户ID

cat_id Int

文件分类ID

id sInt 10000

文件ID

error Int 0

这个值只要有返回,永远是0,用于某些第三方上传插件。

url Url

访问路径

thumbnail Url

缩略图(若非图片,会根据文件类型返回一个图标)

src Url

若为图片,与url一致,若非图片,会根据文件类型返回一个图标

响应示例

{
    "status": 1,
    "data": {
        "raw_name": "gbyp6",
        "file_ext": ".jpg",
        "file_type": "image/jpeg",
        "file_size": 7828,
        "file_path": "./uploads/baike/2017/06/",
        "client_name": "2013031511172436.jpg",
        "is_image": true,
        "image_width": 200,
        "image_height": 200,
        "upload_time": 1497249757,
        "user_id": 0,
        "cat_id": 0,
        "id": "10002",
        "error": 0,
        "url": "http://71.fayfox.com/uploads/baike/2017/06/gbyp6.jpg",
        "thumbnail": "http://71.fayfox.com/uploads/baike/2017/06/gbyp6-100x100.jpg",
        "src": "http://71.fayfox.com/uploads/baike/2017/06/gbyp6.jpg"
    },
    "code": "",
    "message": ""
}