跳转到: 导航, 搜索
第1行: 第1行:
 
{{api_desc_v2|
 
{{api_desc_v2|
 
uri=statuses/upload_pic|
 
uri=statuses/upload_pic|
desc=上传图片,返回图片的图床pic_id、urls |
+
desc=上传图片到素材库 |
 
httpMethod=POST|
 
httpMethod=POST|
 
needAuth=是|
 
needAuth=是|
第24行: 第24行:
 
*original_pic:原始大图|
 
*original_pic:原始大图|
 
useAge=
 
useAge=
*上传成功后获得的pic_id仅用于发多图行为,请勿用于保存或拼凑图片链接,否则今后pic_id升级无法保证拼凑链接的兼容性;
+
*上传成功后获得的 pic_id 可用于发多图、指定视频封面图等功能,但请勿保存用来拼凑图片链接,图片真实链接带有防盗链,无法保证拼凑链接的兼容性;
 
*目前上传图片大小限制为<5M;
 
*目前上传图片大小限制为<5M;
*如果没有登录或超过发布上限,将返回403错误。
+
*如果没有带授权认证信息或超过发布上限,将返回403错误。
 
|
 
|
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

2022年9月9日 (五) 16:01的版本

statuses/upload_pic

上传图片到素材库

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 可用于发多图、指定视频封面图等功能,但请勿保存用来拼凑图片链接,图片真实链接带有防盗链,无法保证拼凑链接的兼容性;
  • 目前上传图片大小限制为<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评价