2/statuses/upload/en
statuses/upload
Upload a picture with a new weibo.
URL
https://api.weibo.com/2/statuses/upload.json
Supported Formats
JSON
HTTP Request Method
POST
Requires Login
true
See the Login and Authorization Mechanism Statement for login and authorization details.
Requests Count Limitation
Level:normal
Count Limitation:true
See the Interface Access Rights Statement for the request count limitation details.
Request Parameters
Requires | Type and Range | Description | |
---|---|---|---|
source | false | string | This parameter is not needed when using OAuth.The value of this parameter is the AppKey. |
access_token | false | string | This parameter is required when using OAuth.You will get the access_token after oauth authorization. |
status | true | string | The weibo content to be posted.It must be encoded by URLEncode within 140 Chinese characters. |
pic | true | binary | Picture to be uploaded. Only support JPEG, GIF, PNG formats.Currently the size of the uploading picture has a 5MB limitation. |
lat | false | float | Latitude: from -90.0 to +90.0; +: North latitude;Default is 0.0. |
long | false | float | Longitude: from -180.0 to +180.0; +: East longitude;Default is 0.0. |
annotations | false | string | Metadatas,this is used to record some informations that will be used for the application,every weibo can have more than one metadata included in json,the max length of json string is 512 characters, the content of the annotations is defined by the developers. |
Notes
Request must be handed in POST method,encode the data with multipart/form-data.
Response
JSON Example
{ "created_at": "Tue May 31 17:46:55 +0800 2011", "id": 11488058246, "text": "求关注。", "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "mid": "5612814510546515491", "reposts_count": 8, "comments_count": 9, "annotations": [], "user": { "id": 1404376560, "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", "domain": "zaku", "gender": "m", "followers_count": 1204, "friends_count": 447, "statuses_count": 2908, "favourites_count": 0, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "remark": "", "geo_enabled": true, "verified": false, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 215 } }
See the Error Code Description for the error information details.
Field Description
Returned Field | Field Type | Field Description |
---|---|---|
idstr | string | Weibo ID of string |
created_at | string | Created time |
id | int64 | Weibo ID |
text | string | Weibo content |
source | string | Weibo source |
favorited | boolean | Whether it is favorited |
truncated | boolean | Whether it is truncated |
in_reply_to_status_id | int64 | The reply’s ID |
in_reply_to_user_id | int64 | Replyer ID |
in_reply_to_screen_name | string | Replyer nickname |
mid | int64 | Weibo MID |
bmiddle_pic | string | Medium picture |
original_pic | string | Original picture |
thumbnail_pic | string | Thumbnail picture |
reposts_count | int | Repost count |
comments_count | int | Comment count |
annotations | array | Weibo annotation information |
geo | object | Geography information |
user | object | User profile that posted the weibo |
Others
None