跳转到: 导航, 搜索
第1行: 第1行:
 
{{api_desc_v2|
 
{{api_desc_v2|
 
uri=statuses/upload_pic|
 
uri=statuses/upload_pic|
desc=上传图片,返回图片picid,urls(3个url) |
+
desc=上传图片,返回图片的图床pic_id、urls |
 
httpMethod=POST|
 
httpMethod=POST|
 
needAuth=是|
 
needAuth=是|
第7行: 第7行:
 
rateLimit=是|
 
rateLimit=是|
 
params=
 
params=
{{api_args|pic|true|string|要上传的图片文件。仅支持JPEG,GIF,PNG图片,为空返回20007错误。目前上传图片大小限制为<5M。}}|
+
{{api_args|pic|true|string|要上传的图片文件。仅支持JPEG、GIF、PNG图片,为空返回20007错误,目前上传图片大小限制为<5M。}}|
 
apiToolPara=|
 
apiToolPara=|
 
relat_qa=<html><div id="relat_qa" data="upload picture"></div></html>|
 
relat_qa=<html><div id="relat_qa" data="upload picture"></div></html>|

2021年2月20日 (六) 13:22的版本

statuses/upload_pic

上传图片,返回图片的图床pic_id、urls

URL

https://api.weibo.com/2/statuses/upload_pic.json

支持格式

JSON

HTTP请求方式

POST

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制

访问级别:高级接口(需要授权)
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
pic true string 要上传的图片文件。仅支持JPEG、GIF、PNG图片,为空返回20007错误,目前上传图片大小限制为<5M。

注意事项

  • 上传成功后获得的pic_id仅用于发多图行为,请勿用于保存或拼凑图片链接,否则今后pic_id升级无法保证拼凑链接的兼容性;
  • 目前上传图片大小限制为<5M;
  • 如果没有登录或超过发布上限,将返回403错误。

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "pic_id": "946308c5jw1dv288whtylj",
    "thumbnail_pic": "http://ww3.sinaimg.cn/thumbnail/946308c5jw1dv288whtylj.jpg",
    "bmiddle_pic": "http://ww3.sinaimg.cn/bmiddle/946308c5jw1dv288whtylj.jpg",
    "original_pic": "http://ww3.sinaimg.cn/large/946308c5jw1dv288whtylj.jpg"
}

关于错误返回值与错误代码,参见 错误代码说明

返回字段说明

  • thumbnail_pic:缩略图
  • bmiddle_pic:中图
  • original_pic:原始大图

其他

相关问题


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




api评价