上传图片并发布一条新微博
https://upload.api.weibo.com/2/statuses/upload.json
JSON
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。 |
{
"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 |
无