分享到 :

add_t

1 接口说明

发表一条微博信息（纯文本）到腾讯微博平台上。
注意连续两次发布的微博内容不可以重复。

1.1 URL

OAuth2.0协议： https://graph.qq.com/t/add_t

1.2 格式

JSON，XML

1.3 HTTP请求方式

POST

1.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738
-OAuth2.0协议必须传入的通用参数，详见这里。
（2）私有参数

参数名称 是否必须 类型 描述
format string 定义API返回的数据格式。
取值说明：为xml时表示返回的格式是xml；为json时表示返回的格式是json。 
注意：json、xml为小写，否则将不识别。format不传或非xml，则返回json格式数据。
content 必须 string 表示要发表的微博内容。必须为UTF-8编码，最长为140个汉字，也就是420字节。
如果微博内容中有URL，后台会自动将该URL转换为短URL，每个URL折算成11个字节。
若在此处@好友，需正确填写好友的微博账号，而非昵称。
clientip string 用户ip。
必须正确填写用户侧真实ip，不能为内网ip及以127或255开头的ip，以分析用户所在地。
longitude string 用户所在地理位置的经度。
为实数，最多支持10位有效数字。有效范围：-180.0到+180.0，+表示东经，默认为0.0。
latitude string 用户所在地理位置的纬度。
为实数，最多支持10位有效数字。有效范围：-90.0到+90.0，+表示北纬，默认为0.0。
syncflag string 标识是否将发布的微博同步到QQ空间（0：同步； 1：不同步；），默认为0。
该参数只支持OAuth1.0，OAuth2.0暂不支持。
compatibleflag string 容错标志，支持按位操作，默认为0。
0x20：微博内容长度超过140字则报错；
0：以上错误均做容错处理，即发表普通微博。

1.5 请求示例

以OAuth2.0协议为例，POST请求包示例：

POST /t/add_t HTTP/1.1
Host: graph.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 352
Connection: Keep-Alive
Cache-Control: no-cache
access_token=*************&oauth_consumer_key=123456&openid=****************&format=json&content=hello

1.6 返回参数说明

参数名称 描述
ret 返回码。
-公共返回码说明详见：公共返回码说明。
-微博OpenAPI私有返回码详见：微博私有返回码说明。
-本接口私有返回码说明详见：这里。
errcode 二级错误码，详见：微博私有返回码说明。
msg 如果ret不为0，会有相应的错误信息提示，返回数据全部用UTF-8编码。
id 微博消息的ID，用来唯一标识一条微博消息。
time 微博消息的发表时间。

1.7 正确返回示例

{
    ret:0,
    msg:"ok",
    errcode:0,
    data:
   {
      id:12345678,
      time:12863444444
   }
}

1.8 错误返回示例

Content-type: text/html; charset=utf-8
{
ret:4,
msg:"禁止访问，城市，QQ号码被加入黑名单",
errcode:5
}
返回顶部