add_topic

特别声明

出于信息安全的考虑,本接口仅对可信赖的合作网站开放。
已经成功接入“QQ登录”的网站需提交申请以获取访问OpenAPI的权限。

目录

1 接口说明

登录用户发布心情,发布以后,将在QQ空间的说说下添加一条动态,以分享给好友。
用户发布心情时,可以是纯文本,也可以带超链接,视频,或者图片的富文本。
本接口支持LBS信息,即用户动态中可以包含位置信息,例如经纬度,地点名称及描述。

第三方网站可以在网站上放置如下面板,用户在文本框内填入文字,也可以选择插入图片,视频,超链接等。 如下图所示:
add_topic_1.png
发表成功后即通过OpenAPI将动态同步到QQ空间,如下图所示:
add_topic_2.png


1.1 URL

https://graph.qq.com/shuoshuo/add_topic

1.2 格式

JSON / XML

1.3 HTTP请求方式

POST

1.4 输入参数说明

各个参数都必须是utf-8编码,且需进行URL 编码,编码时请遵守 RFC 1738

(1)通用参数
OAuth2.0协议必须传入的通用参数,详见这里

(2)私有参数

参数名称 是否必须 类型 描述
richtype string 发布心情时引用的信息的类型。

1表示图片; 2表示网页; 3表示视频。

richval string 发布心情时引用的信息的值。有richtype时必须有richval

(1)当richtype为图片(即richtype为1,应用场景为发布心情时引用某张图片)时,richval需要传入该图片的相关参数。
引用的图片来源分为两种:一种为网站图片,一种为QQ空间相册中的某张图片。

-当引用的图片来自网站,richval包含下列参数的值:

参数名称 是否必须 类型 描述
url 必须 string 网站图片的URL
height 必须 string 图片高度,单位: px
width 必须 string 图片宽度,单位: px


输入时每个值中间用“&”分隔,如下所示:
“url=http://qq.com/logo.png&width=25&height=21”

-当引用的图片来自QQ空间相册,richval包含下列参数的值。
这些值都需要通过调用相册OpenAPI来获得。参数意义如下:

参数名称 是否必须 类型 描述
albumid 必须 string 图片所属空间相册的ID
pictureid 必须 string 图片ID
sloc 必须 string 小图ID
pictype string 图片类型(JPG = 1;GIF = 2;PNG = 3)
picheight string 图片高度,单位: px
picwidth string 图片宽度,单位: px

输入时每个值中间用逗号分隔,如下所示 :
“albumid,pictureid,sloc,pictype,picheight,picwidth”。

(2)当richtype为网页(即richtype为2,应用场景为针对某网页发表评论)时,richval需要传入该网页的URL,发表为feeds时,后台会自动将该URL转换为短URL。

(3)当richtype为视频(即richtype为3,应用场景为针对某视频发表评论)时,richval需要传入该视频的URL,发表为feeds时,后台会对该URL进行解析,在feeds上显示播放器,视频源及缩略图。

con 必须 string
发布的心情的内容。

lbs_nm string 地址文。例如:广东省深圳市南山区高新科技园腾讯大厦。lbs_nm,lbs_x,lbs_y通常一起使用,来明确标识一个地址。

lbs_x string 经度。-180.0到+180.0,+表示东经。

lbs_nm,lbs_x,lbs_y通常一起使用,来明确标识一个地址。

lbs_y string 纬度。-90.0到+90.0,+表示北纬。

lbs_nm,lbs_x,lbs_y通常一起使用,来明确标识一个地址。

format string 定义API返回的数据格式。

取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。
注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。

third_source string 第三方应用的平台类型。

1表示QQ空间; 2表示腾讯朋友; 3表示腾讯微博平台; 4表示腾讯Q+平台。



1.5 请求示例

1. (敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):

access_token=**********
oauth_consumer_key=200003
openid=**********
richtype=3
richval=http://v.youku.com/v_playlist/f6361533o1p0.html
con=123
lbs_nm=腾讯大厦
lbs_x=39.909407
lbs_y=116.397521
format=xml
third_source=1

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

POST /shuoshuo/add_topic HTTP/1.1
Host: graph.qq.com
Content-Length: 340
Connection: Keep-Alive
Cache-Control: no-cache


access_token=**********& oauth_consumer_key=200003& openid=**********& richtype=3& richval=http%3A%2F%2Fv.youku.com%2Fv_playlist%2Ff6361533o1p0.html& con=123& lbs_nm=腾讯大厦& lbs_x=39.909407& lbs_y=116.397521& format=xml


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/shuoshuo/add_topic" 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>
        richtype<input value="3" name="richtype" /><br>
        richval<input value=" http://v.youku.com/v_playlist/f6361533o1p0.html" name="richval" /><br>
        con<input value="真不错" name="con" /><br>
        lbs_nm<input value="腾讯大厦" name="lbs_nm" /><br>
        lbs_x<input value="39.909407" name="lbs_x" /><br>
        lbs_y<input value="116.397521" name="lbs_y" /><br>
        third_source<input value="1" name="third_source" /><br><br>
        <input type="submit" value="发表说说" />
     </form>
  </BODY>
</HTML>

1.6 返回参数说明

参数名称 描述
ret 返回码。
msg 如果ret<0,会有相应的错误信息提示,返回数据全部用UTF-8编码。


1.7 返回码说明

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

错误码 含义说明
-2 系统内部错误。

请通过企业QQ联系QQ支持人员,调查问题原因并获得解决方案。

-3 输入的参数值不符合要求。
-4 不能为空的参数为空,例如参数con的值为空。
-5 输入的参数值超过限制值。
-6 输入的文字内容信息包含敏感词汇。
-7 输入的文字内容信息包含需要审核的敏感词汇。
-104 QQ号码由于各种原因(例如发布敏感信息)被限制使用,无法发布内容。
-106 重复发布相同的内容。
-107 正在发布,请等待。
-109 url是恶意链接或者不符合格式。

(1)当richtype为图片时,上传的图片不符合规格。
(2)当richtype为网页或视频时,网页或视频的url是恶意链接或不符合格式。

-117 权限限制,不允许写操作。
-122 写操作超过频率限制,或无写操作权限,无法进行写操作。

1.8 正确返回示例

<?xml version="1.0" encoding="utf-8"?>
<data>
   <ret>0</ret>
   <msg><![CDATA[]]></msg>
</data>

1.9 错误返回示例

<?xml version="1.0" encoding="UTF-8" ?> 
<root>
<data>
   <ret>-106</ret> 
   <msg><![CDATA[重复发布相同内容]]></msg> 
</data>

</root>

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部