Weibo Platform Logo

微博开放平台

weibo
跳转到： 导航, 搜索
(创建新页面为 '{{api_desc_v2| uri=statuses/update| desc=发布一条新微博| httpMethod=POST| needAuth=是| level={{Api_L1}}| rateLimit=是| params={{api_args|status|true|string|要发布的…')
 
 
（未显示3个用户的11个中间版本）
第6行： 第6行：
 
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：仅自己可见，默认为0。}}
 +
{{api_args|is_longtext|false|int|是否发送超过140字的长文，0：不是长文，1：是长文，设置为1时，status参数可以传超过140字的内容，发布长文微博，默认为0。}}
 
{{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。}}|
 +
apiToolPara=key1=status&value1=微博来自API测试工具|
 +
relat_qa=<html><div id="relat_qa" data="update"></div></html>|
 
result=
 
result=
−
<pre>
+
<pre class="brush:html">
 
{
 
{
−
     "created_at": "Tue May 31 17:46:55 +0800 2011",
+
     "created_at": "Wed Oct 24 23:39:10 +0800 2012",
−
     "id": 11488058246,
+
     "id": 3504801050130000,
−
     "text": "求关注。"，
+
     "mid": "3504801050130827",
−
     "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>",
+
     "idstr": "3504801050130827",
 +
    "text": "定向分组内容。",
 +
    "source": "新浪微博</a>",
 
     "favorited": false,
 
     "favorited": false,
 
     "truncated": false,
 
     "truncated": false,
第22行： 第30行：
 
     "in_reply_to_user_id": "",
 
     "in_reply_to_user_id": "",
 
     "in_reply_to_screen_name": "",
 
     "in_reply_to_screen_name": "",
−
     "geo": null,
+
     "geo": {
−
    "mid": "5612814510546515491",
+
        "type": "Point",
−
    "reposts_count": 8,
+
        "coordinates": [
−
    "comments_count": 9,
+
            40.413467,
−
     "annotations": [],
+
            116.646439
 +
        ]
 +
     },
 
     "user": {
 
     "user": {
−
         "id": 1404376560,
+
         "id": 1902538057,
−
         "screen_name": "zaku",
+
        "idstr": "1902538057",
−
         "name": "zaku",
+
         "screen_name": "张三",
 +
         "name": "张三",
 
         "province": "11",
 
         "province": "11",
−
         "city": "5",
+
         "city": "8",
−
         "location": "北京 朝阳区",
+
         "location": "北京 海淀区",
−
         "description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
+
         "description": "做最受尊敬的互联网产品经理...",
−
         "url": "http://blog.sina.com.cn/zaku",
+
         "url": "",
−
         "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
+
         "profile_image_url": "http://tp2.sinaimg.cn/1902538057/50/22817372040/1",
−
         "domain": "zaku",
+
        "profile_url": "304270168",
 +
         "domain": "shenbinzhu",
 +
        "weihao": "304270168",
 
         "gender": "m",
 
         "gender": "m",
−
         "followers_count": 1204,
+
         "followers_count": 337,
−
         "friends_count": 447,
+
         "friends_count": 534,
−
         "statuses_count": 2908,
+
         "statuses_count": 516,
−
         "favourites_count": 0,
+
         "favourites_count": 60,
−
         "created_at": "Fri Aug 28 00:00:00 +0800 2009",
+
         "created_at": "Sat Dec 25 14:12:35 +0800 2010",
 
         "following": false,
 
         "following": false,
−
         "allow_all_act_msg": false,
+
         "allow_all_act_msg": true,
−
        "remark": "",
+
 
         "geo_enabled": true,
 
         "geo_enabled": true,
 
         "verified": false,
 
         "verified": false,
 +
        "verified_type": 220,
 
         "allow_all_comment": true,
 
         "allow_all_comment": true,
−
         "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1",
+
         "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": 215
+
         "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
 
     }
 
     }
 
}
 
}
 
</pre>|
 
</pre>|
−
resultDes=无|
+
resultDes={{Rdes_status}}|
−
useAge=无|
+
useAge=
 +
*连续两次发布的微博不可以重复；
 +
*非会员发表定向微博，分组成员数最多200。
 +
|
 
otherInfo=无
 
otherInfo=无
−
}}
+
}}{{#a:showgrade}}

2022年9月9日 (五) 16:17的最后版本

statuses/update

发布一条新微博

URL

https://api.weibo.com/2/statuses/update.json

支持格式

JSON

HTTP请求方式

POST

是否需要登录

是
关于登录授权，参见 如何登录授权

访问授权限制

访问级别：普通接口
频次限制：是
关于频次限制，参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数，OAuth授权后获得。
status true string 要发布的微博文本内容，必须做URLencode，内容不超过140个汉字。
visible false int 微博的可见性，0：所有人能看，1：仅自己可见，默认为0。
is_longtext false int 是否发送超过140字的长文，0：不是长文，1：是长文，设置为1时，status参数可以传超过140字的内容，发布长文微博，默认为0。
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。

注意事项

  • 连续两次发布的微博不可以重复；
  • 非会员发表定向微博，分组成员数最多200。

调用样例及调试工具

API测试工具

返回结果

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
    }
}

关于错误返回值与错误代码，参见 错误代码说明

返回字段说明

返回值字段 字段类型 字段说明
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

其他

无

相关问题


到 帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




来自“http://open.weibo.com/wiki/index.php?title=2/statuses/update&oldid=16299”
文档更新时间: 2022-09-09

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA

api评价