2. 图片上传
| 功能 |
接口 |
| 请求方式 |
POST |
| URL |
https://imgkm.xqd.cn/api/upload |
请求参数
| 参数名称 |
类型 |
是否必须 |
说明 |
| image |
File |
是 |
表单名称 |
| token |
String |
否 |
可放在 Header 或表单参数中。传入后图片归属该 Token 用户；不传则按游客上传处理。 |
| expire_days |
Number |
否 |
按天设置有效期。支持 0、7、30、60、180；0 表示永久。默认 30 天。 |
| expired_at |
Number |
否 |
到期 Unix 时间戳，必须晚于当前时间；0 表示永久。优先级高于 expired_date 和 expire_days。 |
| expired_date |
String |
否 |
到期日期，支持 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss；传“永久”、permanent、forever 或 0 表示永久。优先级高于 expire_days。 |
注意：到期参数三选一即可；如果同时传入，优先级为 expired_at > expired_date > expire_days。请求时 Header 如果有参数 token，接口则认证该 token，上传的图片也是在该 token 用户下，否则为游客上传。
返回数据说明
| 参数名称 |
类型 |
实例值 |
说明 |
| code |
Number |
200 |
状态码，成功返回200，失败返回500 |
| msg |
String |
success |
提示信息 |
| time |
Number |
1544176295 |
响应时间戳 |
| data |
array|object |
{
"id": 1,
"name": "9B7BCFBD05891B2D42187F126887777A.jpg",
"url": "http://域名/2018/12/08/5c0b519f44701.jpg",
"size": 30405,
"mime": "image/jpeg",
"sha1": "0143f7904f12e2a76ff2935f21a771b8adadf961",
"md5": "e630c1d832f1701b0afe09cfe86a7f2b",
"expire_days": 0,
"expired_at": 0,
"expired_date": "永久"
}
|
图片数据 |
上传示例
POST /api/upload HTTP/1.1
Host: https://imgkm.xqd.cntoken: 你的Token
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
------WebKitFormBoundaryx2mqINKHVPJ8yMdK
Content-Disposition: form-data; name="expire_days"
0
到期时间示例
# 永久保存
expire_days=0
# 30 天有效
expire_days=30
# 指定 Unix 时间戳到期
expired_at=1798761599
# 指定日期到期，日期格式会按当天 23:59:59 处理
expired_date=2026-12-31
# 指定日期时间到期
expired_date=2026-12-31 23:59:59
# 字符串永久
expired_date=永久
响应错误示例
{
"code": 500,
"msg": "管理员关闭了游客上传！",
"data": null,
"time": 1544245931
}