特别声明:
本接口为新版本接口,推荐新接入的应用使用本接口。原有的【QQ登录】add_weibo接口也提供“发表一条微博”的功能,已经接入的应用可以继续使用。
目录 |
发表一条微博信息(纯文本)到腾讯微博平台上。
注意连续两次发布的微博内容不可以重复。
OAuth2.0协议: https://graph.qq.com/t/add_t
OAuth1.0协议: http://openapi.qzone.qq.com/t/add_t
JSON,XML
POST
各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)通用参数
-OAuth2.0协议必须传入的通用参数,详见这里。
-OAuth1.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,以分析用户所在地。 | |
| jing | string | 用户所在地理位置的经度。 为实数,最多支持10位有效数字。有效范围:-180.0到+180.0,+表示东经,默认为0.0。 | |
| wei | string | 用户所在地理位置的纬度。 为实数,最多支持10位有效数字。有效范围:-90.0到+90.0,+表示北纬,默认为0.0。 | |
| syncflag | string | 标识是否将发布的微博同步到QQ空间(0:同步; 1:不同步;),默认为0。 |
以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
| 参数名称 | 描述 |
|---|---|
| ret | 返回码。 -公共返回码说明详见:【QQ登录】公共返回码说明。 |
| errcode | 二级错误码,详见:【QQ登录】微博私有返回码说明。 |
| msg | 如果ret不为0,会有相应的错误信息提示,返回数据全部用UTF-8编码。 |
| id | 微博消息的ID,用来唯一标识一条微博消息。 |
| time | 微博消息的发表时间。 |
Content-type: text/html; charset=utf-8
{
ret:0,
msg:"ok",
errcode:0,
data:
{
id:12345678,
time:12863444444
}
}
Content-type: text/html; charset=utf-8
{
ret:4, msg:"禁止访问,城市,QQ号码被加入黑名单", errcode:5
}
Copyright © 1998 - 2012 Tencent. All Rights Reserved.
腾讯公司 版权所有