全球看热讯:薄荷图床 上传文件API调用指南
接口地址:会员专用网址/api/upload/
【资料图】
返回格式:JSON
请求方式:POST
默认QPS:30+
Github:https://github.com/chikuairi/bohetuchuang_api
请求参数
参数名称 | 类型 | 必选 | 描述 |
---|
api_token | String | 是 | 您的api_token,用于验证请求者身份。填写错误将导致请求失败,报402错误。 |
---|---|---|---|
uploadedFile | String | 是 | 要上传的文件,缺少该参数报406错误。 |
mode | Number(Int)、String | 否 | 命名方式,可取值1,2,3。1:自动重命名;2:保留原文件名;3:自动重命名(短链接模式)。不填默认为自动重命名。 |
uploadPath | String | 否 | 要上传的目录,不填默认为 年/月/日 目录。多级目录以 / 分隔 |
watermark | Number(Int)、String | 否 | 是否开启水印,可取值1,0。 1:开启水印;0:关闭水印。不填默认为关闭水印。 |
请求示例
1.PHP(在后端请求是一种很好的方式,因为这样可以保护好你的api_token
。)
new \CURLFile("/www/wwwroot/myProduct/demo.jpg"),// 如果使用这个方式请填写文件的绝对路径 "api_token" => "你的token", "mode" => "命名方式", "uploadPath" => "上传目录", "watermark" => "是否开启水印" ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_SAFE_UPLOAD, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); $output = curl_exec($ch); curl_close($ch); // 打印调用结果 echo $output; // 以下代码只是调用结果展示,复制代码后删掉或者注释掉下面内容才能运行 // 响应结果 { "status":"success", "statusCode":"200", "resultData":"success:File uploaded", "url":"返回的文件链接", "originFileName":"原文件名称", "lessurl":"不含https://前缀的链接" } ?>
2.Python(在后端请求是一种很好的方式,因为这样可以保护好你的api_token
。)
# 导入requests包 import requests# 此处仅提供一个简单的示例,具体实现起来方案有很多,可按需开发def python_demo(): url = "你的接口地址" files = {"uploadedFile": ("demo.jpg", open("demo.jpg", "rb"), "image/jpeg")} data = {"api_token": "你的token", "mode": "命名方式", "uploadPath": "上传目录", "watermark": "是否开启水印", } res = requests.post(url, data=data, files=files) print(res.text)python_demo()# 以下代码只是调用结果展示,复制代码后删掉或者注释掉下面内容才能运行# 响应结果{ "status":"success", "statusCode":"200", "resultData":"success:File uploaded", "url":"返回的文件链接", "originFileName":"原文件名称", "lessurl":"不含https://前缀的链接"}
3.Vue2原生+Axios(不推荐直接在公共项目的前端请求接口,因为这样会暴露你的api_token
!)
// 此处仅提供一个简单的示例,具体实现起来方案有很多,可按需开发import Axios from "axios";export default { methods:{ fileUpload(event){ console.log(event); let file = event.target.files let formData = new FormData() formData.append("uploadedFile", file[0]) formData.append("api_token", "你的token"); formData.append("mode", "命名方式"); formData.append("uploadPath", "上传目录"); formData.append("watermark", "是否开启水印"); // 文件上传 Axios.post("你的接口地址", formData) .then((res) => { let data = res.data; console.log(data); }).catch((e)=>{ console.log(e); }) }, }}以下代码只是调用结果展示,复制代码后删掉或者注释掉下面内容才能运行响应结果{ "status":"success", "statusCode":"200", "resultData":"success:File uploaded", "url":"返回的文件链接", "originFileName":"原文件名称", "lessurl":"不含https://前缀的链接"}
4.JQuery Ajax(不推荐直接在公共项目的前端请求接口,因为这样会暴露你的api_token
!)
// 此处仅提供一个简单的示例,具体实现起来方案有很多,可按需开发 function getfilename(){ var uploadedFile = document.getElementById("boheimg").files; var formData = new FormData(); for(var i=0; i"uploadedFile", uploadedFile[i]); } console.log(uploadedFile); formData.append("api_token", "你的token"); formData.append("mode", "命名方式"); formData.append("uploadPath", "上传目录"); formData.append("watermark", "是否开启水印"); $.ajax({ url: "你的接口地址",//传向后台服务器文件 type: "post", //传递方法 data: formData, //传递的数据 dataType : "json", //传递数据的格式 contentType: false, processData: false, success: function (responseStr) { console.log(responseStr) }, error: function () { alert("上传错误!"); } }); } // 以下代码只是调用结果展示,复制代码后删掉或者注释掉下面内容才能运行 // 响应结果 { "status":"success", "statusCode":"200", "resultData":"success:File uploaded", "url":"返回的文件链接", "originFileName":"原文件名称", "lessurl":"不含https://前缀的链接" }
返回值参数说明
参数名称 | 类型 | 描述 | 示例 |
---|
status | String | 返回的状态值。 | success |
---|---|---|---|
statusCode | String | 返回的状态码。 | 200 |
resultData | String | 处理后返回的结果。 | success:File uploaded |
url | String | 返回的文件链接 | https://123.com/abc.jpg |
lessurl | String | 不含https://前缀的链接 | 123.com/abc.jpg |
originFileName | String | 原文件名称 | abc.jpg |
返回值示例
一般情况下都会返回下列状态码:
{ "status":"success", "statusCode":"200", "resultData":"success:File uploaded", "url":"返回的文件链接", "originFileName":"原文件名称", "lessurl":"不含https://前缀的链接"}
返回状态码说明
状态码 | 描述 |
---|
200 | 成功 |
---|---|
401 | 失败:未开启API上传功能。(在后台开启即可) |
402 | 失败:api_token错误。(请查证api_token) |
403 | 失败:文件尺寸超限。(升级套餐或调整文件尺寸) |
405 | 失败:未被支持的扩展名(文件格式)。 |
406 | 失败:没有选择文件就执行了上传操作。 |
407 | 失败:账号违规,API被封禁。 |
500 | 失败:其他错误或服务器内部错误。(请联系客服处理) |
标签:
-
2022-09-15 14:23:06
杨莉娜租借加盟巴黎圣日耳曼 与姆巴佩梅西拉莫斯一起共事<
北京时间9月13日下午,法甲女足俱乐部巴黎圣日耳曼正式官宣中国女足国脚杨莉娜完成租借加盟,合同期至2023年6月。杨莉娜成为目前国家队中第
-
2022-02-07 14:57:45
奇迹!绝杀!女足亚洲杯逆转夺冠!<
刚刚,中国女足上演逆转绝杀奇迹!她们在亚洲杯决赛中3:2力克韩国队,时隔16年再夺亚洲杯冠军!
-
2022-02-07 14:57:45
中国政府与阿根廷共和国政府签署共建“一带一路”谅解备忘录<
新华社北京2月6日电(记者安蓓)国家发展改革委6日称,国家发展改革委主任何立峰与阿根廷外交、国际贸易和宗教事
-
2022-02-07 14:57:43
中华人民共和国和阿根廷共和国关于深化中阿全面战略伙伴关系的联合声明(全文)<
新华社北京2月6日电中华人民共和国和阿根廷共和国关于深化中阿全面战略伙伴关系的联合声明一、应中方邀请,阿根廷
-
2022-02-07 14:57:40
春节假期国内旅游出游2.51亿人次<
春节遇冬奥,旅游年味浓。根据文化和旅游部数据中心测算,2022年春节假期7天,全国国内旅游出游2 51亿人次,同比
-
2023-09-09 13:56:46
骑马与砍杀战团npc组合mod(骑马与砍杀战团npc组合)
骑马与砍杀战团npc组合mod,骑马与砍杀战团npc组合这个很多人还不知道,
-
2023-09-09 12:09:28
油价越涨,美元越高?
油价越涨,美元越高?,沙特,原油价格,美元指数,国际油价
-
2023-09-09 10:22:54
保险科技十年百人评选启动,找寻保险科技最重要的力量!
保观|聚焦保险创新如果说十年是一个轮回,那中国保险科技行业的发展,
-
2023-09-09 08:57:28
刘和平:美乌“憋大招”,乌克兰真正大反攻要来了?
直新闻:我们看到,美国在犹豫了一段时间之后,终于步英国后尘,向乌军
-
2023-09-09 07:05:13
3-0横扫日本伊藤美诚,3-0碾压日本平野美宇,陈幸同打爆2位强敌
以3-2艰难逆转穆克吉之后,陈幸同在女单1 8决赛,迎来老对手平野美宇。
-
2023-09-09 02:23:45
股票行情快报:熵基科技(301330)9月8日主力资金净卖出224.56万元
截至2023年9月8日收盘,熵基科技(301330)报收于33 7元,上涨0 3%,换手
-
2023-09-08 21:56:04
70多位家属一起报警,国家真的有必要来一场严打了!
70多位家属一起报警,国家真的有必要来一场严打了!,报警,黑恶势力,犯
-
2023-09-08 18:47:28
郑氏点银:黄金缓慢反弹关注1930上,原油88下谨防修正
郑氏点银:黄金缓慢反弹关注1930上,原油88下谨防修正回顾昨日行情走势
-
2023-09-08 17:48:39
这条路上我们一起走歌词走伴奏(这条路上我们一起走歌词)
1、牵着手一起走2、演唱:小臭臭卢齐炜3、词曲:泰歌4、推广:朱军亮5
-
2023-09-08 16:49:26
蓝英装备涨20.00%
蓝英装备涨20 00%
-
2023-09-08 15:21:23
不锈钢蜂窝阳极管之特点与应用
在当今现代工业领域,不锈钢材料的应用十分广泛,而不锈钢蜂窝阳极管作
-
2023-09-08 14:12:28
年终旺季+季节性户外运动同启 eBay运动户外品类持续热销
每年的年终旺季时值季节的重要转换,具有较强季节性的户外运动将在第四
-
2023-09-08 12:58:41
一心堂(002727.SZ):股东阮鸿献先生进行股票质押式回购交易延期
2023年9月7日晚,一心堂(002727 SZ)发布关于公司股东阮鸿献先生进行股
-
2023-09-08 11:37:38
《星空》游戏发布 知名游戏工作室绘制贺图
《星空》游戏已于9月6日正式发布,这是贝塞斯达时隔多年推出的新IP。该
-
2023-09-08 10:39:08
7月至12月,河北开展高校毕业生等青年就业服务攻坚行动
日前,省人社厅印发《关于开展2023年河北省高校毕业生等青年就业服务攻
-
2023-09-08 10:01:41
官方:湖人正式与小斯科蒂-皮蓬等4名球员签下Exhibit-10合同
官方:湖人正式与小斯科蒂-皮蓬等4名球员签下Exhibit-10合同,湖人,夏联
-
2023-09-01 10:47:08
两部门:降低存量首套房房贷利率
中国人民银行、金融监管总局8月31日联合发布《关于降低存量首套住房贷
-
2023-09-01 09:49:46
AI监管呼声再起!美国前众议长佩洛西:AI是把“双刃剑”
美国前众议院议长南希·佩洛西表示,快速发展的人工智能领域需要监管护
-
2023-09-01 07:47:30
中航光电08月31日被深股通减持1.47万股
08月31日,中航光电被深股通减持1 47万股,最新持股量为1082 61万股,
-
2023-09-01 06:10:34
8月制造业PMI升至49.7%
8月制造业PMI升至49 7%(主题)中工网北京8月31日电(工人日报-中工网
-
2023-09-01 01:53:20
尿酮体阳性是什么病(尿酮体阳性是什么意思)
您好,现在汉格来为大家解答以上的问题。尿酮体阳性是什么病,尿酮体阳
-
2023-08-31 21:59:17
药物毒理学--生殖毒性(关于药物毒理学--生殖毒性简述)
,你们好,今天0471房产来聊聊一篇物毒理学--生殖毒性,物毒理学--生殖
-
2023-08-31 20:39:07
【魅力鹰城·种业芯片篇】昔日贡品张良姜 今成群众致富姜
2023年8月31日《平顶山晚报》2版□平报融媒记者胡耀华文 图“冬吃萝卜
-
2023-08-31 19:12:32
维持原判!江某莲自诉林某侮辱、诽谤上诉一案二审宣判
8月31日,福建省南平市中级人民法院依法对江某莲自诉林某侮辱、诽谤上
-
2023-08-31 18:03:45
GPLP投融资:阿维塔科技获30亿元 福碳科技获1亿元
作者:李东耳阿维塔科技完成B轮30亿元融资阿维塔科技近日完成B轮30亿元
-
2023-08-31 16:57:26
大哥大传奇好玩吗 大哥大传奇玩法简介
期待已久的手游大哥大传奇即将登陆九游,这款手机游戏吸引了大批玩家的
-
2023-08-31 15:32:32
全国城市一刻钟便民生活圈典型案例发布 重庆三个社区入选
近日,商务部发布亮点突出、创新性强、有借鉴意义的60个全国城市一刻钟
-
2023-08-31 14:26:08
哈尔滨市公安局“三个聚焦”全面推进反诈宣传
哈尔滨市公安局以打造反诈防诈宣传新阵地为切入点,牢固树立“以宣促安
-
2023-08-31 13:02:58
实现下一代车载信息娱乐系统
Posted07 20 2023byMarkHoopes,DirectorofAutomotive&IndustrialSegmen
-
2023-08-31 11:33:28
午评:A股又跌了,还能看反弹吗?听听老手怎么说
不得不说确实非常的闹心,A股今天上午收盘又是全线飘绿的状态,三大
-
骑马与砍杀战团npc组合mod(骑马与砍杀战团npc组合)
2023-09-09 13:56:46 -
油价越涨,美元越高?
2023-09-09 12:09:28 -
保险科技十年百人评选启动,找寻保险科技最重要的力量!
2023-09-09 10:22:54 -
刘和平:美乌“憋大招”,乌克兰真正大反攻要来了?
2023-09-09 08:57:28 -
3-0横扫日本伊藤美诚,3-0碾压日本平野美宇,陈幸同打爆2位强敌
2023-09-09 07:05:13 -
股票行情快报:熵基科技(301330)9月8日主力资金净卖出224.56万元
2023-09-09 02:23:45 -
70多位家属一起报警,国家真的有必要来一场严打了!
2023-09-08 21:56:04