分享到 :

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 正确返回示例

1.8 错误返回示例

返回顶部