请求说明
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": "" }