开源【QQ登录】Connect QQ Java SDK 1.1 发布

1.1 功能说明

当用户在外资使用QQ登录时，允许第三方网站调用分享的API，以用户的名义发布一条动态。

第三方所传输的信息，一次性传输给分享的API接口，同旧有的分享接口的实现方式有所区别。

目前已经对外公布的旧同步feed接口，将迁移到分享的新接口当中。

同步的feed在后台数据上要求可以同其他分享的feed进行区分

本文档说明的是支持第一类API接口：分享网页

例如：某用户在土豆网上传了一个网页，将在QQ空间中以该用户的名义发表一条动态，动态的具体展示如下：

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

(1)用户评论：用户在第三方网站发布的评论等UGC信息，选填项

(2)链接的URL和中文名：点击后跳转至第三方网页，必填项

(3)详细描述：对网页的详细描述，选填项

(4)外部图片：引用外部图片，不超过100X100大小，选填项

(5)分享的场景：支持以下场景 1.通过网页 2.通过手机 3.通过软件  4.通过IPHONE 5.通过

IPAD，选填项 

1.2 URL

http://openapi.qzone.qq.com/share/add_share

1.3 格式

JSON 、XML

1.4 HTTP请求方式

POST

1.5 输入参数说明

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

通用参数
发送请求时必须包含OAuth流程Step7中规定的通用请求参数，详见这里。 

（2）私有参数
   

   //必须（最长36个中文字，超出部分会被截断）

   title: "feeds标题", 对应功能说明的 ②

   //必须 （请以http://开头）分享所在网页资源的链接,点击后跳转至第三方网页 

   url: "feeds的url地址",对饮功能说明的② 的链接

   //可选。禁止使用系统生产的语句进行代替 （最长40个中文字，超出部分会被截断）

   comment: "用户评论内容，也叫发表分享时的分享理由", 对应功能说明的‚

   //可选 （最长80个中文字，超出部分会被截断）

   summary: "所分享的网页资源的摘要内容,或者是网页的概要描述 ",对应功能说明的ƒ

   //可选 （请以http://开头，长度限制255字符，目前第一张图片有效，多张图片以竖线（|）分隔，图片规格100*100为佳）

   images: "所分享的网页资源的代表性图片链接",对应功能说明的④

  //可选 (值 xml,表示返回的格式是xml，值json：表示返回的格式是json)

  format :表示api返回的数据格式

  //可选 (//1.通过网页 2.通过手机 3.通过软件  4.通过IPHONE 5.通过 IPAD)

  source :分享的场景  对应功能说明的⑥

1.6 请求示例

示例：

1. 请求参数（敏感信息都用*号进行了处理，实际请求中需要替换成真实的值）： 

oauth_version=1.0
oauth_signature_method=HMAC-SHA1&
oauth_timestamp=1304673799
oauth_nonce=1606161364
oauth_consumer_key=200003
oauth_token==**********
openid==**********
format=xml
title=QQ空间
url=http://www.qzone.com/
comment=真不错
summary=我的生活我的时尚
images=http://imgcache.qq.com/QzonePortal_v2/city_v2/img/news_img/2011/0526/portal_new_1306376959_00375.jpg
oauth_signature==********** 

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

POST /share/add_share 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=**********& title%3DQQ%E7%A9%BA%E9%97%B4%26url%3Dhttp%3A%2F%2Fwww.qzone.com%2F%26comment%3D%E7%9C%9F%E4%B8%8D%E9%94%99%26summary%3D%E6%88%91%E7%9A%84%E7%94%9F%E6%B4%BB%E6%88%91%E7%9A%84%E6%97%B6%E5%B0%9A%26images%3Dhttp%3A%2F%2Fimgcache.qq.com%2FQzonePortal_v2%2Fcity_v2%2Fimg%2Fnews_img%2F2011%2F0526%2Fportal_new_1306376959_00375.jpg & oauth_signature=********** 

1.7 返回参数说明

示例：

ret: 返回码 

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

1.8 返回码说明

0: 正确返回
其它: 失败。错误码说明详见：【QQ登录】公共返回码说明。 

1.9 正确返回示例

<?xml version=\"1.0\" encoding=\"utf-8\"?>

<data>

<ret>0</ret>

<msg><![CDATA[]]></msg>

</data>

1.10 错误返回示例

<?xml version=\"1.0\" encoding=\"utf-8\"?>

<data>

<ret>1000</ret>

<msg><![CDATA[缺少必要输入参数]]></msg>

</data>