C/2/statuses/update/biz
第11行: | 第11行: | ||
{{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|false|string|开发者上报的操作用户真实IP,形如:211.156.0.1。}} | + | <!-- {{api_args|rip|false|string|开发者上报的操作用户真实IP,形如:211.156.0.1。}}--> |
{{api_args|is_longtext|false|int|是否发送超过140字微博,0:不超过140字,1:超过140字但在2000字以内,默认为0。操作用户需满足发送超过140字微博资格。}} | {{api_args|is_longtext|false|int|是否发送超过140字微博,0:不超过140字,1:超过140字但在2000字以内,默认为0。操作用户需满足发送超过140字微博资格。}} | ||
{{api_args|custom_source|false|string|自定义小尾巴。例如,{“name”:""}为不显示小尾巴。}}| | {{api_args|custom_source|false|string|自定义小尾巴。例如,{“name”:""}为不显示小尾巴。}}| |
2020年3月17日 (二) 10:39的版本
statuses/update/biz
发布一条微博信息。
URL
https://c.api.weibo.com/2/statuses/update/biz.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
status | true | string | 要发布的微博文本内容,必须做URLencode。 |
visible | false | int | 微博的可见性,0:所有人能看,1:仅自己可见,2:密友可见,3:指定分组可见,默认为0。 |
list_id | false | string | 微博的保护投递指定分组ID,只有当visible参数为3时生效且必选。 |
lat | false | float | 纬度,有效范围:-90.0到+90.0,+表示北纬,默认为0.0。 |
long | false | float | 经度,有效范围:-180.0到+180.0,+表示东经,默认为0.0。 |
annotations | false | string | 元数据,主要是为了方便第三方应用记录一些适合于自己使用的信息,每条微博可以包含一个或者多个元数据,必须以json字串的形式提交,字串长度不超过512个字符,具体内容可以自定。 |
is_longtext | false | int | 是否发送超过140字微博,0:不超过140字,1:超过140字但在2000字以内,默认为0。操作用户需满足发送超过140字微博资格。 |
custom_source | false | string | 自定义小尾巴。例如,{“name”:""}为不显示小尾巴。 |
注意事项
- 连续两次发布的微博不可以重复;
- 非会员发表定向微博,分组成员数最多200;
返回结果
JSON示例
//成功返回 { "created_at": "Wed Oct 24 23:39:10 +0800 2012", "id": 3504801050130000, "mid": "3504801050130827", "idstr": "3504801050130827", "text": "定向分组内容。", "source": "新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "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 } }, "annotations": [ { "aa": "cc" } ], "reposts_count": 0, "comments_count": 0, "attitudes_count": 0, "mlevel": 0, "visible": { "type": 3, "list_id": 3469454702570000 } } //失败返回 { "request": "/statuses/update/biz.json", "error_code": XXXXX, "error": "error message." }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无