第1行: | 第1行: | ||
{{api_desc_v2| | {{api_desc_v2| | ||
uri=statuses/upload_pic| | uri=statuses/upload_pic| | ||
− | desc= | + | desc=上传图片,返回图片的图床pic_id、urls | |
httpMethod=POST| | httpMethod=POST| | ||
needAuth=是| | needAuth=是| | ||
第7行: | 第7行: | ||
rateLimit=是| | rateLimit=是| | ||
params= | params= | ||
− | {{api_args|pic|true|string| | + | {{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错误。
调用样例及调试工具
返回结果
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:原始大图
其他
无
相关问题
到 帮助中心 查看更多问题或提问