add_feeds

特别声明

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

2. 建议网站将请求的频率限制在每秒1次以下。如请求过于频繁,该接口将可能被禁用。

3. 本接口将被add_share接口替代。原有已经使用了add_feeds接口的网站需要进行代码改造,迁移到新的add_share接口上来。


目录

1 接口说明

使用“QQ登录”登录网站的用户如果在网站上进行操作(例如上传视频,图片,发表评论等)后,将以该用户的名义发布一条动态(feeds)到QQ空间中,展现给好友。

例如:某用户在土豆网上传了一个视频,将在QQ空间中以该用户的名义发表一条动态,动态的具体展示如下:
add_feeds_1.png

上图中的1-6标注对feeds的组成以及规格进行了说明:

1:表示用户在网站上进行的操作。
2:表示外部资源的网页链接地址,包含链接名和URL。
3:表示用户在网站上发表的评论(禁止使用系统生产的语句进行代替)。
4:表示外部资源的缩略图(大小不超过100 x 100 px)。
5:表示外部资源的内容描述。
6:表示feeds的来源,根据登录的网站自动展示相关信息。

1.1 URL

http://openapi.qzone.qq.com/feeds/add_feeds

1.2 格式

POST

1.3 HTTP请求方式

POST

1.4 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)通用参数
发送请求时必须传入通用的OAuth相关参数,详见这里

(2)私有参数
feeds_data: 包含feeds的所有内容,请用JSON方式进行组织。下面以一个feeds_data的示例详细说明了fees_data的内容:

{

   //必须。值的含义:1:常用feeds(可以含图);2:上传视频;3:上传音频。
   "action": 1,	
   
   //必须(最长36个中文字,超出部分会被截断)
   "title": "feeds标题", 


   //必须 (请以http://开头)
   "titleurl": "feeds的url地址",


   //可选。禁止使用系统生产的语句进行代替	(最长40个中文字,超出部分会被截断)
   "comment": "用户评论内容",	


   //可选	(最长80个中文字,超出部分会被截断)
   "summary": "feeds的摘要内容",


   //可选。action为1时生效,目前只允许一张图,只需填url1即可。尺寸为100*100 px时最佳。
   "img": 
   { 
       "url1": "图片1地址", 
       "url2": "图片2地址",
       "url3": "图片3地址"
   },


   //可选。action为2时生效。
   "video": 
   {	        
       "url": "视频地址",
       "img": "视频缩略图"
   },


   //可选。action为3时生效。
   "audio": 
   {        
       "url": "音频地址",
       "img": "音频缩略图"
   }

}

1.5 请求示例

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

oauth_version=1.0
oauth_signature_method=HMAC-SHA1&
oauth_timestamp=1304673799
oauth_nonce=1606161364
oauth_consumer_key=200003
oauth_token==**********
openid==**********
feeds_data= { "action": 1,

   "title": "给力视频", 
   "titleurl": "http://www.tudou.com/programs/view/fkBXdGp6pYg/"

}
oauth_signature==**********

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

POST /feeds/add_feeds HTTP/1.1
Host: openapi.qzone.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 431

oauth_version=1.0& oauth_signature_method=HMAC-SHA1& oauth_timestamp=1304673799& oauth_nonce=1606161364& oauth_consumer_key=200003& oauth_token=**********& openid=**********& feeds_data=%7B%22title%22%3A+%22%E7%BB%99%E5%8A%9B%E8%A7%86%E9%A2%91%22%2C%22action%22%3A+1%2C%22titleurl%22%3A+%22http%3A%2F%2Fwww.tudou.com%2Fprograms%2Fview%2FfkBXdGp6pYg%2F%22%7D& oauth_signature=**********

1.6 返回参数说明

ret: 返回码

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

1.7 返回码说明

0: 正确返回
其它: 失败。错误码说明详见:公共返回码说明

1.8 正确返回示例

 <html>
    <head>
       <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    </head>
    <body>
       <script type="text/javascript">
           document.domain="qq.com";
           frameElement.callback( {"ret":"0","type":"","msg":"ok"} );
       </script>
    </body>
 </html>


展示效果如下(这是一条最简单的feeds,请按照feeds_data的描述来丰富feeds的内容):

add_feeds_2.png

1.9 错误返回示例

  <html>
     <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     </head>
     <body>
        <script type="text/javascript">
           document.domain="qq.com";
           frameElement.callback( {"ret":"1000","type":"","msg":"params error."} );
        </script>
     </body>
  </html>

1.10 代码示例

请从SDK下载页面下载PHP SDK,在feeds文件夹下的add_feeds.php文件中找到相应的示例代码。

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部