分享到 :

add_weibo

特别声明
本接口即将在2012年3月26日下线,已经接入的应用请尽早修改代码,改为调用add_t接口。

1 接口说明

已经开通微博的用户登录网站并发布一条消息后,可以将该消息同步到腾讯微博。
用户发布的微博,可以是纯文本,也可以是带图片的富文本。目前尚不支持视频播放。

1.1 URL

OAuth2.0协议: https://graph.qq.com/wb/add_weibo

1.2 格式

JSON,XML

1.3 HTTP请求方式

POST

1.4 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)通用参数
-OAuth2.0协议必须传入的通用参数,详见这里
 

参数名称 是否必须 类型 描述
format string 定义API返回的数据格式。
取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。 
注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。
type 必须 string 表示发表的微博类型。固定取值为1。
content 必须 string 表示要发表的微博内容。必须为UTF-8编码,最长为140个UTF-8汉字,也就是420字节。 
如果微博内容中有URL,后台会自动将该URL转换为短URL,每个URL折算成11个字节。
img string 图片的URL。

1.5 请求示例

1. 请求参数以OAuth2.0协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):

access_token=*************
oauth_consumer_key=123456
openid=****************
format=xml
content=hello
type=1
img=http://imgcache.qq.com/QzonePortal_v2/city_v2/img/news_img/2011/0524/0_1306226329_07511.jpg

2. 对参数进行URL编码后拼接出的POST请求包:

POST /wb/add_weibo HTTP/1.1
Host: graph.qzone.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=xml& content=hello& type=1 &
img=http%3a%2f%2fimgcache.qq.com%2fQzonePortal_v2%2fcity_v2%2fimg%2fnews_img%2f2011%2f0524%2f0_1306226329_07511.jpg

3.下面是Post请求的HTML Form代码,开发者可以使用此表单来测试(供PC网页使用):

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
  <HEAD>
     <TITLE> New Document </TITLE>
     <META NAME="Generator" CONTENT="EditPlus">
     <META NAME="Author" CONTENT="">
     <META NAME="Keywords" CONTENT="">
     <META NAME="Description" CONTENT="">
  </HEAD>
  <BODY>
     <form action="https://graph.qq.com/wb/add_weibo " method="post">
        access token<input value="********..." name="access_token" /><br>
        appid<input value="222222" name="oauth_consumer_key" /><br>
        openid<input value="="********" " name="openid" /><br>
        con<input value="hellocon" name="con" /><br>
        url<input value=" http://www.qzone.com/  " name="url" /><br>
        content<input value="真不错" name="content" /><br>
        type<input value="1" name="type" /><br>
        img<input value="http://imgcache.qq.com/QzonePortal_v2/city_v2/img/news_img/2011/0526/
portal_new_1306376959_00375.jpg" name="img" /><br><br>
        <input type="submit" value="发表微博" />
     </form>
  </BODY>
</HTML>

1.6 返回参数说明

参数名称 描述
ret 返回码。
msg 如果ret不为0,会有相应的错误信息提示,返回数据全部用UTF-8编码
ID 微博消息的ID,用来唯一标识一条微博消息。
time 微博消息的发表时间。

1.7 返回码说明

0: 正确返回,发表微博成功。
其它: 失败。
OpenAPI公共错误码说明详见:公共返回码说明
本接口私有错误码说明如下:

错误码 含义说明
3001 - 3003, 
3006 - 3007
3010 - 3011
3024
系统内部错误。 
请通过zx_qq.gif联系的QQ登录支持人员,调查问题原因并获得解决方案。
3004 发表的微博内容中含有敏感词。
3005 用户微博被禁止访问。
3008 内容超过最大长度:420字节(以进行短url处理后的长度计)。
3009 微博内容中包含垃圾信息,例如:广告、恶意链接。 
或发布微博用户的QQ号进入了微博的黑名单。
3012 发表的微博消息在审核中,请等待。
3013 在短时间(一分钟)内发表同样内容的微博。
3020 用户未开通微博。
3021 微博消息的内容过长,超过800字节。
3022 微博消息的内容编码不是UTF-8。
3023 发表的微博消息的内容为空。
3025 不是POST请求。

1.8 正确返回示例

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <msg>ok</msg>
  <ret>0</ret>
  <id>416803434344</id>
  <time>1300703127</time>
</data>

1.9 错误返回示例

<?xml version="1.0" encoding="UTF-8"&nbsp;?>
<root>
   <data>
       <ret>3013</ret>
       <msg><![CDATA[重复发表]]></msg>
   </data>
</root>
返回顶部