add_weibo
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
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
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公共错误码说明详见:公共返回码说明。
本接口私有错误码说明如下:
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" ?> <root> <data> <ret>3013</ret> <msg><![CDATA[重复发表]]></msg> </data> </root>