API 说明文档
上传接口地址:https://cloud.firgt.cn/api.php
支持 JSON、JSONP、FORM 三种返回方式,支持 Web 跨域调用,也可在程序中直接调用。请求方式:
POST multipart/form-data。
请求参数说明
| 字段名 | 变量名 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| 文件 | file | 是 | - | multipart 格式文件 |
| 是否首页显示 | show | 否 | 1 | 默认为是 |
| 是否设置密码 | ispwd | 否 | 0 | 默认为否 |
| 下载密码 | pwd | 否 | 123456 | 默认留空 |
| 返回格式 | format | 否 | json | json / jsonp / form,默认 json |
| 跳转页面 URL | backurl | 否 | http://... | 仅 form 格式有效 |
| Callback | callback | 否 | callback | 仅 jsonp 格式有效 |
返回参数说明
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 上传状态 | code | Int | 0 | 0 成功,其他失败 |
| 提示信息 | msg | String | 上传成功! | 失败时返回错误描述 |
| 文件 MD5 | hash | String | f1e807cb… | - |
| 文件名称 | name | String | example.jpg | - |
| 文件大小 | size | Int | 58937 | 单位:字节 |
| 文件格式 | type | String | jpg | - |
| 下载地址 | downurl | String | http://... | - |
| 预览地址 | viewurl | String | http://... | 仅图/音/视有值 |
文件删除接口(DELETE)
请求方式:
DELETE application/x-www-form-urlencoded,必要参数 hash,若文件设置了密码还需提交 file_pwd。curl -X DELETE \
-d "hash=3a78c73f88489c8f33c0e430683b5d5&file_pwd=123456" \
https://cloud.firgt.cn/api.php
成功响应
{
"code": 0,
"msg": "文件删除成功"
}
失败响应
{
"code": -1,
"msg": "文件密码错误"
}
若文件未设密码,只能通过后台管理界面删除。