(未显示3个用户的4个中间版本) | |||
第1行: | 第1行: | ||
{{api_desc_v2_sp| | {{api_desc_v2_sp| | ||
− | host= | + | host=https://upload.api.weibo.com/2/| |
uri=statuses/upload| | uri=statuses/upload| | ||
desc=上传图片并发布一条新微博| | desc=上传图片并发布一条新微博| | ||
第7行: | 第7行: | ||
level={{Api_L1}}| | level={{Api_L1}}| | ||
rateLimit=是| | rateLimit=是| | ||
− | params={{api_args|status|true|string|要发布的微博文本内容,必须做URLencode,内容不超过140个汉字。}} | + | params= |
+ | {{api_args|status|true|string|要发布的微博文本内容,必须做URLencode,内容不超过140个汉字。}} | ||
+ | {{api_args|visible|false|int|微博的可见性,0:所有人能看,1:仅自己可见,2:密友可见,3:指定分组可见,默认为0。}} | ||
+ | {{api_args|list_id|false|string|微博的保护投递指定分组ID,只有当visible参数为3时生效且必选。}} | ||
{{api_args|pic|true|binary|要上传的图片,仅支持JPEG、GIF、PNG格式,图片大小小于5M。}} | {{api_args|pic|true|binary|要上传的图片,仅支持JPEG、GIF、PNG格式,图片大小小于5M。}} | ||
{{api_args|lat|false|float|纬度,有效范围:-90.0到+90.0,+表示北纬,默认为0.0。}} | {{api_args|lat|false|float|纬度,有效范围:-90.0到+90.0,+表示北纬,默认为0.0。}} | ||
{{api_args|long|false|float|经度,有效范围:-180.0到+180.0,+表示东经,默认为0.0。}} | {{api_args|long|false|float|经度,有效范围:-180.0到+180.0,+表示东经,默认为0.0。}} | ||
− | {{api_args|annotations|false|string|元数据,主要是为了方便第三方应用记录一些适合于自己使用的信息,每条微博可以包含一个或者多个元数据,必须以json字串的形式提交,字串长度不超过512个字符,具体内容可以自定。}}| | + | {{api_args|annotations|false|string|元数据,主要是为了方便第三方应用记录一些适合于自己使用的信息,每条微博可以包含一个或者多个元数据,必须以json字串的形式提交,字串长度不超过512个字符,具体内容可以自定。}} |
+ | {{api_args|rip|true|string|开发者上报的操作用户真实IP,形如:211.156.0.1,请传操作用户的真实有效IP。}} | ||
+ | | | ||
+ | relat_qa=<html><div id="relat_qa" data="upload"></div></html>| | ||
result= | result= | ||
<pre> | <pre> | ||
{ | { | ||
− | "created_at": " | + | "created_at": "Wed Oct 24 23:49:17 +0800 2012", |
− | "id": | + | "id": 3504803600500000, |
− | " | + | "mid": "3504803600502730", |
− | " | + | "idstr": "3504803600502730", |
+ | "text": "分组定向图片微博", | ||
+ | "source": "新浪微博</a>", | ||
"favorited": false, | "favorited": false, | ||
"truncated": false, | "truncated": false, | ||
第24行: | 第32行: | ||
"in_reply_to_user_id": "", | "in_reply_to_user_id": "", | ||
"in_reply_to_screen_name": "", | "in_reply_to_screen_name": "", | ||
− | " | + | "thumbnail_pic": "http://ww2.sinaimg.cn/thumbnail/71666d49jw1dy6q8t3p0rj.jpg", |
− | " | + | "bmiddle_pic": "http://ww2.sinaimg.cn/bmiddle/71666d49jw1dy6q8t3p0rj.jpg", |
− | " | + | "original_pic": "http://ww2.sinaimg.cn/large/71666d49jw1dy6q8t3p0rj.jpg", |
− | " | + | "geo": { |
− | + | "type": "Point", | |
+ | "coordinates": [ | ||
+ | 40.413467, | ||
+ | 116.646439 | ||
+ | ] | ||
+ | }, | ||
"user": { | "user": { | ||
− | "id": | + | "id": 1902538057, |
− | "screen_name": " | + | "idstr": "1902538057", |
− | "name": " | + | "screen_name": "张三", |
+ | "name": "张三", | ||
"province": "11", | "province": "11", | ||
− | "city": " | + | "city": "8", |
− | "location": "北京 | + | "location": "北京 海淀区", |
− | "description": " | + | "description": "做最受尊敬的互联网产品经理...", |
− | "url": " | + | "url": "", |
− | "profile_image_url": "http:// | + | "profile_image_url": "http://tp2.sinaimg.cn/1902538057/50/22817372040/1", |
− | "domain": " | + | "profile_url": "304270168", |
+ | "domain": "shenbinzhu", | ||
+ | "weihao": "304270168", | ||
"gender": "m", | "gender": "m", | ||
− | "followers_count": | + | "followers_count": 337, |
− | "friends_count": | + | "friends_count": 534, |
− | "statuses_count": | + | "statuses_count": 516, |
− | "favourites_count": | + | "favourites_count": 60, |
− | "created_at": " | + | "created_at": "Sat Dec 25 14:12:35 +0800 2010", |
"following": false, | "following": false, | ||
− | "allow_all_act_msg": | + | "allow_all_act_msg": true, |
− | + | ||
"geo_enabled": true, | "geo_enabled": true, | ||
"verified": false, | "verified": false, | ||
+ | "verified_type": 220, | ||
"allow_all_comment": true, | "allow_all_comment": true, | ||
− | "avatar_large": "http:// | + | "avatar_large": "http://tp2.sinaimg.cn/1902538057/180/22817372040/1", |
"verified_reason": "", | "verified_reason": "", | ||
"follow_me": false, | "follow_me": false, | ||
"online_status": 0, | "online_status": 0, | ||
− | "bi_followers_count": | + | "bi_followers_count": 185, |
+ | "lang": "zh-cn", | ||
+ | "level": 7, | ||
+ | "type": 1, | ||
+ | "ulevel": 0, | ||
+ | "badge": { | ||
+ | "kuainv": { | ||
+ | "level": 0 | ||
+ | }, | ||
+ | "uc_domain": 0, | ||
+ | "enterprise": 0, | ||
+ | "anniversary": 0 | ||
+ | } | ||
+ | }, | ||
+ | "reposts_count": 0, | ||
+ | "comments_count": 0, | ||
+ | "attitudes_count": 0, | ||
+ | "mlevel": 0, | ||
+ | "visible": { | ||
+ | "type": 3, | ||
+ | "list_id": 3469454702570000 | ||
} | } | ||
} | } | ||
</pre>| | </pre>| | ||
resultDes={{Rdes_status}}| | resultDes={{Rdes_status}}| | ||
− | useAge=请求必须用POST方式提交,并且注意采用multipart/form- | + | useAge= |
+ | *请求必须用POST方式提交,并且注意采用multipart/form-data编码方式; | ||
+ | *非会员发表定向微博,分组成员数最多200。 | ||
+ | | | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} |
2022年6月9日 (四) 14:29的最后版本
statuses/upload
上传图片并发布一条新微博
URL
https://upload.api.weibo.com/2/statuses/upload.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:普通接口
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
status | true | string | 要发布的微博文本内容,必须做URLencode,内容不超过140个汉字。 |
visible | false | int | 微博的可见性,0:所有人能看,1:仅自己可见,2:密友可见,3:指定分组可见,默认为0。 |
list_id | false | string | 微博的保护投递指定分组ID,只有当visible参数为3时生效且必选。 |
pic | true | binary | 要上传的图片,仅支持JPEG、GIF、PNG格式,图片大小小于5M。 |
lat | false | float | 纬度,有效范围:-90.0到+90.0,+表示北纬,默认为0.0。 |
long | false | float | 经度,有效范围:-180.0到+180.0,+表示东经,默认为0.0。 |
annotations | false | string | 元数据,主要是为了方便第三方应用记录一些适合于自己使用的信息,每条微博可以包含一个或者多个元数据,必须以json字串的形式提交,字串长度不超过512个字符,具体内容可以自定。 |
rip | true | string | 开发者上报的操作用户真实IP,形如:211.156.0.1,请传操作用户的真实有效IP。 |
注意事项
- 请求必须用POST方式提交,并且注意采用multipart/form-data编码方式;
- 非会员发表定向微博,分组成员数最多200。
返回结果
JSON示例
{ "created_at": "Wed Oct 24 23:49:17 +0800 2012", "id": 3504803600500000, "mid": "3504803600502730", "idstr": "3504803600502730", "text": "分组定向图片微博", "source": "新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "thumbnail_pic": "http://ww2.sinaimg.cn/thumbnail/71666d49jw1dy6q8t3p0rj.jpg", "bmiddle_pic": "http://ww2.sinaimg.cn/bmiddle/71666d49jw1dy6q8t3p0rj.jpg", "original_pic": "http://ww2.sinaimg.cn/large/71666d49jw1dy6q8t3p0rj.jpg", "geo": { "type": "Point", "coordinates": [ 40.413467, 116.646439 ] }, "user": { "id": 1902538057, "idstr": "1902538057", "screen_name": "张三", "name": "张三", "province": "11", "city": "8", "location": "北京 海淀区", "description": "做最受尊敬的互联网产品经理...", "url": "", "profile_image_url": "http://tp2.sinaimg.cn/1902538057/50/22817372040/1", "profile_url": "304270168", "domain": "shenbinzhu", "weihao": "304270168", "gender": "m", "followers_count": 337, "friends_count": 534, "statuses_count": 516, "favourites_count": 60, "created_at": "Sat Dec 25 14:12:35 +0800 2010", "following": false, "allow_all_act_msg": true, "geo_enabled": true, "verified": false, "verified_type": 220, "allow_all_comment": true, "avatar_large": "http://tp2.sinaimg.cn/1902538057/180/22817372040/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 185, "lang": "zh-cn", "level": 7, "type": 1, "ulevel": 0, "badge": { "kuainv": { "level": 0 }, "uc_domain": 0, "enterprise": 0, "anniversary": 0 } }, "reposts_count": 0, "comments_count": 0, "attitudes_count": 0, "mlevel": 0, "visible": { "type": 3, "list_id": 3469454702570000 } }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
created_at | string | 微博创建时间 |
id | int64 | 微博ID |
mid | int64 | 微博MID |
idstr | string | 字符串型的微博ID |
text | string | 微博信息内容 |
source | string | 微博来源 |
favorited | boolean | 是否已收藏,true:是,false:否 |
truncated | boolean | 是否被截断,true:是,false:否 |
in_reply_to_status_id | string | (暂未支持)回复ID |
in_reply_to_user_id | string | (暂未支持)回复人UID |
in_reply_to_screen_name | string | (暂未支持)回复人昵称 |
thumbnail_pic | string | 缩略图片地址,没有时不返回此字段 |
bmiddle_pic | string | 中等尺寸图片地址,没有时不返回此字段 |
original_pic | string | 原始图片地址,没有时不返回此字段 |
geo | object | 地理信息字段 详细 |
user | object | 微博作者的用户信息字段 详细 |
retweeted_status | object | 被转发的原微博信息字段,当该微博为转发微博时返回 详细 |
reposts_count | int | 转发数 |
comments_count | int | 评论数 |
attitudes_count | int | 表态数 |
mlevel | int | 暂未支持 |
visible | object | 微博的可见性及指定可见分组信息。该object中type取值,0:普通微博,1:私密微博,3:指定分组微博,4:密友微博;list_id为分组的组号 |
pic_ids | object | 微博配图ID。多图时返回多图ID,用来拼接图片url。用返回字段thumbnail_pic的地址配上该返回字段的图片ID,即可得到多个图片url。 |
ad | object array | 微博流内的推广微博ID |
其他
无
文档更新时间: 2022-06-09