图片上传

功能 上传图片接口
HTTP 请求方式 POST
URL http://www.17uw.cn/api/upload
https://www.17uw.cn/api/upload

请求参数

参数名称 类型 是否必须 描述
iufile File 表单名称。上传图片用到
ssl Bool 是否使用 https 输出
format String 输出的格式。强制json

返回数据说明

名称 类型 示例值 描述
code String success 上传文件状态。正常情况为 success。出现错误时为 error
filename String 17uw.jpg 上传文件时所用的文件名
storename String 561cc4e3631b1.png 上传后的文件名
size Int 187851 文件大小
width Int 1157 图片的宽度
height Int 680 图片的高度
hash String nLbCw63NheaiJp1 随机字符串,用于删除文件
delete String http://www.17uw.cn/api/delete/?hash=SUrZ1ekCoBoxNix 删除上传的图片文件专有链接
url String http://pic.ik87.cn/2018/01/19/ADN8Z77q.png 图片服务器地址
path String /2018/01/19/ADN8Z77q.png 图片的相对地址
msg String No files were uploaded. 上传图片出错时将会出现

错误列表

未获取到上传文件!
不支持的图片格式或文件损坏!
无法连接数据库!
文件大小超过限制!
上传服务器未返回任何信息!
上传服务器返回的信息无法被解释!
上传成功但无法将文件信息存入数据库!
Error AuthToken.
No files are uploaded because there is no extension name
Could not save uploaded file.
File is empty.

上传示例

POST /api/upload HTTP/1.1
Host: www.17uw.cn
Connection: keep-alive
Content-Length: 57398
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarypAIqI1RWBfPWiOKq

------WebKitFormBoundaryETllier6KwDhrqDZ
Content-Disposition: form-data; name="iufile"; filename="bg.png"
Content-Type: image/png


------WebKitFormBoundaryETllier6KwDhrqDZ
Content-Disposition: form-data; name="file_id"

0
------WebKitFormBoundaryETllier6KwDhrqDZ--

响应示例

{
    "code": "success",
    "data": {
        width: 1157,
        height: 680,
        filename: "image_2015-08-26_10-54-48.png",
        storename: "56249afa4e48b.png",
        size: 69525,
        path: "/2018/01/19/2kSNMaqp.png",
        hash: "nLbCw63NheaiJp1",
        time: 2017-12-11 05:26:00pm,
        url: "http://pic.ik87.cn/2018/01/19/2kSNMaqp.png",
        delete: "http://www.17uw.cn/api/delete/?hash=hNxi3iNstKL3vol"
    }
}

响应错误示例

{
    code: "error",
    msg: "No files were uploaded."
}

新浪图床上传

功能 图片上传到新浪图床接口
HTTP 请求方式 POST
URL http://www.17uw.cn/api/upload/weibo
https://www.17uw.cn/api/upload/weibo

请求参数

参数名称 类型 是否必须 描述
iufile File 表单名称。上传图片用到
ssl Bool 是否使用 https 输出,为true时输出链接为https
format String 输出的格式。强制json

返回数据说明

名称 类型 示例值 描述
code String success 上传文件状态。正常情况为 success。出现错误时为 error
filename String 17uw.jpg 上传文件时所用的文件名
size Int 187851 文件大小
width Int 1157 图片的宽度
height Int 680 图片的高度
url String https://ws3.sinaimg.cn/large/0072Lfvtly1fnmcv8yoeej31720m8n0t.jpg 图片服务器地址
msg String No files were uploaded. 上传图片出错时将会出现

错误列表

未获取到上传文件!
不支持的图片格式或文件损坏!
上传失败,请联系管理员

上传示例

POST /api/upload HTTP/1.1
Host: www.17uw.cn
Connection: keep-alive
Content-Length: 57398
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarypAIqI1RWBfPWiOKq

------WebKitFormBoundaryOMTABcAaPuR54CtJ
Content-Disposition: form-data; name="iufile"; filename="bg.png"
Content-Type: image/png


------WebKitFormBoundaryOMTABcAaPuR54CtJ
Content-Disposition: form-data; name="file_id"

0
------WebKitFormBoundaryOMTABcAaPuR54CtJ--

响应示例

{
    "code": "success",
    "data": {
        width: 1157,
        height: 680,
        filename: "image_2015-08-26_10-54-48.png",
        size: 69525,
        url: "https://ws3.sinaimg.cn/large/0072Lfvtly1fnmcv8yoeej31720m8n0t.jpg"
    }
}

响应错误示例

{
    code: "error",
    msg: "No files were uploaded."
}