跳转到: 导航, 搜索

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错误,目前上传图片大小限制为<10M。

注意事项

  • 上传成功后获得的 pic_id 可用于发多图、指定视频封面图等功能,但请勿保存用来拼凑图片链接,图片真实链接带有防盗链,无法保证拼凑链接的兼容性;
  • 请求格式,Context-Type 须为 multipart/form-data,图片文件数据须放在 pic 参数中;
  • 如果没有带授权认证信息或超过发布上限,将返回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}}}|中文]]




文档更新时间: 2022-09-09