C/2/statuses/upload url text/biz-en
statuses/upload_url_text/biz
Publish a post and upload selected pictures or urls of picture.
URL
https://c.api.weibo.com/2/statuses/upload_url_text/biz.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
Request all APIs:
- 50000/hour/IP;
- 50000/hour/IP;
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 | Text content to be published, must be URL encoded, and not exceeding 140 Chinese characters. |
| visible | false | int | The visibility of the post, 0 for everyone, 1 for oneself, 2 for close friend, 3 for designated group, default as 0. |
| list_id | false | string | Desiganated group ID to which post visible to, required and effective only when parameter visible is 3. |
| url | false | string | URL address of pictures, must start with http. |
| pic_id | false | string | IDs of uploaded pictures, separated by half-width comma, maximum 9. |
| lat | false | float | Latitude, range from -90.0 to +90.0, in which '+' means North, default as 0.0 |
| long | false | float | Longitude, range from -180.0 to +180.0, in which '+' means East, default as 0.0 |
| annotations | false | string | Metadata, for third party application record necessary information. Each post contains one or more metadata, in json format, and no more than 512 characters, content could be self-defined. |
| rip | false | string | The real user IP address reported by the developer, formatted like: 211.156.0.1. |
| is_longtext | false | int | whether to post a status with more than 140 characters ，0：less than 140 characters，1：more than 140 characters but less than 2000 characters，default value is 0. |
Notes
- Must choose one between picid and url. picid is preferable when both of them exist.
- Two consecutive posts could not be the same;
- Non-member user can only publish directed post to group less than 200 people.
Response
JSON Example
//成功返回
{
"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
}
}
//失败返回
{
"request": "/statuses/upload_url_text/biz.json",
"error_code": XXXXX,
"error": "error message."
}
See the Error Code Description for the error information details.
Field Description
none
Others
none
文档更新时间: 2018-05-29
