开发文档
文档正文将由 WordPress 导出文件迁移生成。运行 scripts/import_wordpress.py 完成首次导入。
- 2026年QQ互联春节放假通知
- 分享微信小程序到QQ
- QQ 互联分享签名分享方案
- 2025年QQ互联春节放假通知
- HarmonyOS_SDK常见问题
- HarmonyOS_SDK历史变更
- HarmonyOS_SDK接口说明
- HarmonyOS_SDK环境搭建
- 【QQ互联】access_token有效期调整
- SDK接入使用说明文档
- 【QQ互联】头像系统架构优化调整通知
- 【QQ互联】分享小程序消息字段调整通知
- QQ互联分享功能存储权限适配
- 【通知】QQ互联网站应用——登录授权项展示逻辑升级改造
- 手Q OpenSDK适配IOS16粘贴板
- QQ互联对账号登录增加短信验证
- 【QQ互联】个人隐私保护改造
- 重置QQ/Tim安装信息内存缓存
- 【QQ互联】access_token有效期调整
- 【QQ互联】个人隐私保护改造
- 获取用户是否已授权获取设备信息
- 设置用户是否已授权获取设备信息
- 设置用户是否同意授权隐私权限
- 设置用户是否同意隐私协议(3.5.7)
- Android_SDK历史变更
- 支持屏蔽二维码登录Web页下载链接
- 跳转到手Q的应用授权详情页
- QQApiMiniProgramLaunchObject(3.3.9)
- 支持第三方应用横屏下登录授权完成后恢复横屏
- QQ互联SDK隐私保护声明
- 分享配置相关
- QQ互联将于2020年7月6日进行universal link的校验工作,请开发者关注!
- iOS_SDK历史变更
- 解析游戏组队透传的参数
- 业务自定义输出互联sdk日志
- 获取用户信息接口
- 分享功能存储权限适配
- iOS_SDK头文件所有API接口说明
- TencentWebViewDelegate
- TencentSessionDelegate
- TencentLoginDelegate
- 获取用户OpenID
- TencentOpenApi发送任务统一接口
- CGI类任务创建接口
- 取消指定API调用
- 赠送或请求礼物
- 发起PK或发送炫耀
- 发送应用邀请
- QQ定向分享
- QZone相册/粉丝/日志/说说/设置QQ头像
- TencentOAuth授权登录相关方法
- TencentApiInterface
- TencentApiInterfaceDelegate
- 请求类
- TencentImageAndVideoMessageObjV1
- TencentVideoMessageV1
- TencentAudioMessageObjV1
- TencentImageMessageObjV1
- TencentTextMessageObjV1
- TencentBaseMessageObj
- TencentApiResp
- TencentApiReq
- TCAPIRequestDelegate协议
- QQApiInterface
- QQApiInterfaceDelegate协议
- ShowMessageFromQQReq
- SendMessageToQQResp
- SendMessageToQQReq
- GetMessageFromQQReq
- QQApiThirdAppJoinGroupObject
- QQApiThirdAppBindGroupObject
- QQApiGameConsortiumBindingGroupObject
- QQApiAddFriendObject
- QQApiExtraServiceObject(3.3.7)
- QQApiLaunchMiniProgramObject(3.3.7)
- SendMessageToQQResp
- SendMessageToQQReq
- QQBaseResp
- QQBaseReq
- QQApiVideoForQZoneObject
- QQApiImageArrayForQZoneObject
- QQApiImageArrayForFaceCollectionObject(3.3.5)
- QQApiVideoForQQAvatarObject(3.3.5)
- QQApiImageForQQAvatarObject(3.3.5)
- QQApiResultObject
- QQApiAdItem(已废弃)
- QQApiNewsObject
- QQApiVideoObject
- QQApiAudioObject
- QQApiFileObject
- QQApiWebImageObject(2.9.0)
- QQApiImageObject
- QQApiExtendObject
- QQApiURLObject
- QQApiTextObject
- QQApiObject
- 打印日志(3.3.8)
- QQ互联近期将启动Universal Links校验,请开发者及时更新适配。
- Universal Links适配FAQ
- 互联3.3.7 SDK版本已发布,加强了登录场景的合法性校验,请开发者及时更新适配。
- 唤起小程序/小游戏
- 接入指引
- 应用场景
- 唤起手Q小程序(3.3.7)(QQ 8.1.8)
- 校验Token是否有效
- QQ互联将于2019年12月1日进行Universal Links校验,请开发者及时更新适配
- QQ 互联UnionID打通业务自助处理指引
- iOS3.3.6 SDK版本支持Universal Links的跳转方式,请开发者及时更新适配
- 创建、填写及校验UniversalLinks
- 处理QQ业务的Universal Links回调
- 能力部署
- 接入背景
- 设置QQ头像(废弃)
- 分享到QQ空间(无需QQ登录)
- 分享消息到QQ(无需QQ登录)
- 初始化session
- 读取session
- 保存Session会话信息
- 是否支持分享到QQ空间
- 是否支持分享到QQ
- 是否支持SSO登录
- 获取Token对象
- 判断是否登录且获取OpenId
- 设置OpenId
- 设置token和过期时间
- 获取登录用户openid
- 获取token过期时间
- 获取AccessToken
- 获取APPID
- 当前会话是否有效
- 设置QQ表情
- 设置动态头像
- 设置QQ头像
- 分享视频到空间
- 分享图片到空间
- 获取相册列表
- 分享到QZone
- 获取用户信息
- 分享消息类型&代码示例(详细请参见SDK中Demo)
- 访问OpenApi接口
- 分享图片/表情到QQ表情收藏(3.3.5)(QQ 8.0.5)
- 校验token
- 校验token并统计DAU
- 设置头像(3.3.5)(QQ 8.0.5)
- 注销
- 分享ark消息到QQ(3.3.3)
- OEM应用市场登录/校验登录态
- 分享小程序消息到QQ和空间 (3.3.5)(QQ 8.0.8)
- Server-Side登录模式
- 处理QQ业务的回调
- 登录/校验登录态
- 分享到QQ和QQ空间
- 增量授权
- Android_SDK功能列表
- 获取用户授权参数说明
- 退出账号
- 扫码登录(3.3.3)
- iOS_SDK功能列表
- 授权登录
- 加强QQ互联移动应用 Android包名和 iOS Bundleid 校验的通知
- QQ互联 iOS SDK 接入指南
背景 QQ互联SDK封装了QQ的登录授权以及大部分OpenAPI,应用只需要修改相应参数,不需要理解验证授权流程,即可快速实现QQ登录功能。 集成 下载并解压SDK: 下载链接 拖拽 TencentOpenAPI 文件到Xcode工程内(请勾选 ==Copy items if needed==);或拷贝SDK文件到工程的物理目录下,选中工程==Target -> General -> Linked Frameworks and Libraries -> Add Other== 然后找到对应文件添加即可 添加依赖库。 *SystemConfiguration.framework* 必要的配置 新增一条URL scheme:选中工程==Target -> Info -> URLTypes==;新的scheme命名为:tencent+appid(ex: tencent123456) 添加白名单:LSApplicationQueriesSchemes新增白名单,详见demo; Appdelegate的handleOpenURL代理方法中中添加处理回调的代码。 [QQApiInterface handleOpenURL:url delegate:(id<QQApiInterfaceDelegate>)[QQApiShareEntry class]]; if (YES == [TencentOAuth CanHandleOpenURL:url]) { return [TencentOAuth HandleOpenURL:url]; } API使用说明 初始化SDK 创建TencentOAuth并初始化其appid,demo示例为222222,delegate不能为空。 NSString *appid = __TencentDemoAppid_; _oauth = [[TencentOAuth alloc] initWithAppId:appid andDelegate:self]; 登录授权 登录时,调用TencentOAuth对象的authorize方法,permissions是应用需要用户授权API列表,详见==sdkdef.h==; NSMutableArray * perm
- UnionID介绍
接口说明: 此接口用于获取个人信息。开发者可通过openID来获取用户的基本信息。特别需要注意的是,如果开发者拥有多个移动应用、网站应用,可通过获取用户的unionID来区分用户的唯一性,因为只要是同一QQ互联平台下的不同应用,unionID是相同的。换句话说,同一用户,对同一个QQ互联平台下的不同应用,unionID是相同的。(需邮件申请相关权限。点此申请) 请求方式: (一)https请求方式:GET https://graph.qq.com/oauth2.0/me?access_token=ACCESSTOKEN&unionid=1 参数 是否必需 说明 access_tokenD 是 用户凭证 unionid 否 是否申请unionID 返回说明: 正确的Json返回结果 callback( { "client_id":"YOUR_APPID", "openid":"YOUR_OPENID", "unionid":"YOUR_UNIONID" } ); 错误的Json返回示例 Callback( { "error":100016, "error_description":"access token check failed", } ); 错误码 描述 说明 100016 access token check failed 用户凭据过期(90天)或者不正确 100048 companyid not set 未申请unionID接口调用权限,请邮件申请 (二)Android_SDK 请求方式: 调用获取unionID信息接口的示例代码如下 private void getUnionId() { if (mTencent != null && mTencent.isSessionValid()) { IUiListener listener = new IUiListener() { @Override public void onError(UiError e) { Toast.makeText(MainActivity.this,"onError",Toast.LENGTH_LONG).show(); } @Override p
- 互联加强网站应用回调地址校验通知
近期QQ互联进行整体安全升级,为了保障QQ用户的安全,以免被恶意盗用,互联会对网站应用的回调地址加强校验,请各位开发商检查网站应用的回调地址是否按照要求填写,在3月8日前完成检查确认。 回调地址修改方法:点击查看 如果你是应用开发者,修改回调遇到问题,请联系企业QQ:800013811咨询。 QQ互联团队 2018年02月27日
- 用户基本信息中的用户头像URL域名变更通知
为提供更稳定的接口服务,通过QQ登录接口获取用户基本信息时,用户头像URL字段的域名将从q.qlogo.cn变更为thirdqq.qlogo.cn。原域名将逐步失效,为保证服务稳定,请开发者重新调用接口,更新用户头像URL信息。受影响的接口如下: 1、QQ授权登录功能中的拉取用户信息接口 get_user_info QQ互联团队 2018年02月11日
- 春节期间互联审核工作安排
2018春节假期间(2月13日至2月24日),QQ互联将暂停审核及邮件支持工作,各位开发商请于2月12日之前提交相关申请,后续提交的申请将于春节后审核完成。 请各位开发者尽快提交,避免对业务开展造成影响,对此带来的不便,敬请谅解。 QQ互联团队 2018年2月9日
- iOS侧判断安装QQ接口
/** 1·检测QQ或者TIM是否安装 2·检测是否支持分享 \return 如果已安装QQ或者TIM则返回YES,否则返回NO */ + (BOOL)isSupportShareToQQ; 1.接口说明 判断用户手机是否安装手机QQ及TIM 2.使用场景 开发者可以使用该接口来判断当前手机是否已安装QQ或者TIM,也可用于判断是否支持分享 3.调用方式: If ([QQApiInterface isSupportShareToQQ]) { //QQ或者TIM已安装 //支持分享 } else { //QQ或者TIM未安装 //不支持分享 }
- 重大通知:QQ互联在移动端上只支持QQ/TIM授权登录
近期QQ进行整体安全升级,原有部分第三方开发者通过H5进行账号密码登录的方式,存在潜在安全风险。1月31日起,第三方移动应用使用QQ登录时,仅可使用QQ或TIM进行一键授权登录,除此以外的其他所有登录方式将全部停止支持。 具体方案: 1、移动应用使用OpenSDK时,直接调起一键授权登录,如果未安装QQ或TIM则提示进行下载; 2、移动网站使用QQ登录功能时,将直接调起QQ或TIM一键授权登录。
- ARK分享能力简介
QQ轻应用简介: 轻应用为QQ打造了新一代消息体,相比当前使用的结构化消息具有明显的优势,包括: 全新的卡片展示形式:以支持展示更多有价值的信息。 支持可交互操作:信息卡片上可支持交互操作,大幅提升了用户操作的便捷性。 支持动态信息更新:卡片上承载的信息可实时更新状态,适用于服务状态实时变动的场景。 如何支持轻应用: 为了降低第三方业务信息以轻应用形式在QQ内展示,互联已更新了对应SDK,业务方只需要更新SDK版本,即可体验QQ轻应用。(请注意:此功能暂未开放,具体开通时间敬请等候通知)
- SDK游戏应用接入F&Q文档
一:申请QQ登陆相关问题 1:申请QQ登录需不需要审核?申请处理的时间一般为多长? A:需要通过审核。创建应用后便可以立即获取QQ登录相关的appkey和appid。审核过程大约5个工作日,未审核通过的 appid只能使用注册的QQ号码进行测试登录,审核通过的可以全量使用。 2:申请QQ登录时提示“网站域名验证失败”? A:验证失败可能由于以下原因导致: ①验证代码未添加成功,请查看验证代码是否已成功添加到网站的HEAD标签中。 ②添加的验证代码与当前登录QQ号不匹配,不同QQ号进行验证时生成的验证码不同,请确认当前进行验证的QQ号生成的验证码与添加到网页源代码里的相同。 3:同一个开发者帐号的android/iOS应用创建appid不一致? A:进入腾讯开放平台官网:http://open.qq.com/ 点击管理中心,找到您的android/iOS应用点击进去,点击右上角的平台信 息,点击平台信息创建相关的iOS/android应用,应用名称和 appid即为一致的。 4:如何添加应用调试者帐号? A:进入腾讯开放平台官网:http://open.qq.com/ 点击管理中心,找到您的android应用点击进去,点击下面的QQ登录图标,在添加调试者下面添加您需要测试的QQ号(必须为开发者帐号的QQ好友帐号)。 5:与其它网站的登录接入是否有冲突? A:QQ登录使用国际通用的的OAuth2.0协议进行验证与授权,第三方网站访问腾讯的用户信息时,使用的是腾讯公司为网 站分配的access token,因此第三方网站与其它网站的登录接入并不受影响。 6:没开空间的QQ号码登录的时候不能自动跳转到网站?有别的解决方案吗? A:目前只能建议用户开通QQ空间。后续腾讯会优化这里的体验,非开通用户也能够正常使用QQ登录来登录网站。 7:为什么用户用QQ帐号登录部分网站不能一键登录,还需要再输入用户名和邮箱? A:这个与网站自身逻辑有关。一般来说用户第一次使用QQ帐号登录网站时,网站需要用户输入用户名和密码来实现QQ 帐号和网站自身帐号的绑定。 8:登录分享图标不正确如何处理? A:请您确认以下两点信息: (1)确定用户应用代码中的appid是否配置正确(应用图标是根据appid来拉取后台的图标数据的); (
- QQ登录
登录/授权 通过调用Tencent类的login函数发起登录/校验登录态。 该API具有两个作用: (1)如果开发者没有调用mTencent实例的setOpenId、setAccessToken API,则该API执行正常的登录操作; (2)如果开发者先调用mTencent实例的setOpenId、setAccessToken API,则该API执行校验登录态的操作。如果登录态有效,则返回成功给应用,如果登录态失效,则会自动进入登录流程,将最新的登录态数据返回给应用。 建议开发者在每次应用启动时调用一次该API(先调用setOpenId、setAccessToken),以确保每次打开应用时用户都是有登录态的。 调用登录API的示例代码如下: private void doLogin() { IUiListener listener = new BaseUiListener() { @Override protected void doComplete(JSONObject values) { updateLoginButton(); } }; mTencent.login(this, SCOPE, listener); } 调用登录API参数说明如下: 参数 参数说明 activity 调用者activity。应用使用SDK时,会从应用自己的Activity跳转到SDK的Activity,应用调用SDK的Activity即为这里的调用者activity。 scope 应用需要获得哪些API的权限,由“,”分隔。 例如:SCOPE = “get_user_info,add_t”;所有权限用“all” listener 回调API,IUiListener实例。 注:在某些低端机上调用登录后,由于内存紧张导致APP被系统回收,登录成功后无法成功回传数据。 解决办法如下 在调用login的Activity或者Fragment重写onActivityResult方法,示例代码如下: protected void onActivityResult(int request
- 分享到QQ空间
分享到QQ空间 完善了分享到QZone功能,分享类型参数Tencent.SHARE_TO_QQ_KEY_TYPE,目前只支持图文分享。Tencent. shareToQzone()函数可直接调用,不用用户授权(使用手机QQ当前的登录态)。调用后将打开手机QQ内QQ空间的界面,或者用浏览器打开QQ空间页面进行分享操作。 示例代码如下: private void shareToQzone () {//分享类型 params.putString(QzoneShare.SHARE_TO_QQ_KEY_TYPE,SHARE_TO_QZONE_TYPE_IMAGE_TEXT ); params.putString(QzoneShare.SHARE_TO_QQ_TITLE, "标题");//必填 params.putString(QzoneShare.SHARE_TO_QQ_SUMMARY, "摘要");//选填 params.putString(QzoneShare.SHARE_TO_QQ_TARGET_URL, "跳转URL");//必填 params.putStringArrayList(QzoneShare.SHARE_TO_QQ_IMAGE_URL, "图片链接ArrayList"); mTencent.shareToQzone(activity, params, new BaseUiListener()); } params参数说明如下: 参数 是否必填 类型 参数说明 QzoneShare.SHARE_TO_QQ_KEY_TYPE 选填 Int SHARE_TO_QZONE_TYPE_IMAGE_TEXT(图文) QzoneShare.SHARE_TO_QQ_TITLE 必填 Int 分享的标题,最多200个字符。 QzoneShare.SHARE_TO_QQ_SUMMARY 选填 String 分享的摘要,最多600字符。 QzoneShare.SHARE_TO_QQ_TARGET_URL 必填 String 需要跳转的链接,URL字符串。 QzoneShare.SHARE_TO_QQ_IMAGE_URL 选填 String 分享的图片, 以ArrayList<String>的类型传入,以便支持多张图片(注:
- 游戏内添加好友
添加好友 游戏SDK通过调用Tencent类的gameMakeFriend调用添加好友接口,参数如下: Params:Bundle类型调用参数,必须包含:openid, label, messag,version字段。参数含义如下: 参数 参数说明 MGameAppOperation.GAME_FRIEND_OPENID String型,要添加好友的openid MGameAppOperation.GAME_FRIEND_LABEL String 型,要添加好友的备注 MGameAppOperation.GAME_FRIEND_ADD_MESSAGE String型,验证信息 MGameAppOperation.GAME_SDK_VERSION String型,是否来自游戏SDK 注意:和原来的加好友接口不同:需要传递参数MGameAppOperation.GAME_SDK_VERSION 调用接口的示例代码如下: Bundle params = new Bundle(); params.putString(MGameAppOperation.GAME_FRIEND_OPENID, fopenid.getText() + ""); params.putString(MGameAppOperation.GAME_FRIEND_LABEL, label.getText() + ""); params.putString(MGameAppOperation.GAME_FRIEND_ADD_MESSAGE, message.getText() + ""); params.putString(MGameAppOperation.GAME_SDK_VERSION, "true"); mTencent.makeFriend(GameLogicActivity.this, params);
- 游戏SDK错误码解析
错误码解析 错误码 错误码含义 221001 已有绑定群 221002 未绑定群 221003 绑群回包错误 221004 登录态错误 221005 当前用户不是群主 221006 无效的openid 221007 参数无效 221008 该app无接口调用权限 221009 不是公会成员 221010 达到创建群上限 221011 创建群频率过高 221012 群被删除了 其他错误码:系统错误。
- 内部浏览器接入
内部浏览器接入 AndroidManifest配置 样例如下: <activity android:name="com.tencent.connect.webview.BrowserActivity" android:configChanges="orientation|screenSize" android:process=":web" > meta-data android:name="titlebar_hideable" android:value="true"/> <meta-data android:name="toolbar_portrait_hideable" android:value="false"/> <meta-data android:name="toolbar_landscape_hideable" android:value="false"/> </activity> <activity android:name="com.tencent.connect.webview.JumpShareActivity" /> 注意:如果浏览器需要运行在不同的进程,可参照样例将BrowserActivity设置在不同的进程中,但是JumpShareActivity必须在主进程中(持有Tencent对象的进程)。 另外如果运行屏幕旋转,建议设置: android:configChanges="orientation|screenSize", 滑动隐藏特性 gamesdk浏览器组件支持向上滑动时隐藏导航栏以给玩家更大的浏览空间,此项功能是可配置的。 参考配置样例,各个参数意义如下: - titlebar_hideable : 是否隐藏标题栏 - toolbar_portrait_hideable : 浏览器竖屏时,导航栏是否可滑动隐藏(true为可滑动隐藏); - toolbar_landscape_hideable : 浏览器横屏时,导航栏是否可滑动隐藏 打开浏览器 内部浏览器支持提供b
- 绑群功能
一键绑群 通过调用Tencent类的gameBindGroup调用绑定群接口,参数如下: Params: Bundle类型调用参数,必须包含的参数含义如下: 参数 是否必填 类型 参数说明 GameAppOperation.GAME_UNION_ID 是 String 公会ID GameAppOperation.GAME_ZONE_ID 是 String 游戏区域ID GameAppOperation.GAME_UNION_NAME 是 String 公会名称 GameAppOperation.GAME_ROLE_ID 是 String 游戏角色ID GameAppOperation.GAME_APP_KEY 是 String 与APPID对应,第三方申请 注意:和原来的加好友接口不同:需要传递参数GameAppOperation.GAME_SDK_VERSION 调用接口的示例代码如下: mTencent = Tencent.createInstance(APPID, this); Bundle params = new Bundle(); params.putString(GameAppOperation.GAME_UNION_ID, unionid.getText().toString()); params.putString(GameAppOperation.GAME_ZONE_ID , zoneid.getText()); params.putString(GameAppOperation.GAME_UNION_NAME,union_name.getText()); params.putString(GameAppOperation.GAME_ROLE_ID, role_id.getText()); params.putString(GameAppOperation.GAME_APP_KEY, appkey.getText()); mTencent.gameBindGroup(this, params); 注意:CGI调用需要登录态!!!
- iOS-登录及分享
1. SSO安全登录QQ帐号 iOS SDK支持应用跳转到手机QQ进行登录,给用户提供更加安全、快捷的体验 。 如果用户没有安装手机QQ,且开发者具有webview权限,则显示登录页;如果开发者没有webview权限,sdk版本大于等于2.9,则显示登录页,sdk版本小于2.9,则显示下载页。由于跳转至下载页在当前苹果app审核有被拒风险,所以,希望开发者尽快升级是用最新版sdk。 1.1 授权登录 整个授权过程可以分为,发送请求获取用户授权以及获取用户授权结果两个部分。 发送请求获取用户授权: 在取得用户授权之前,首先必须清楚自己需要用户的哪些信息,iOS SDK提供多种选择,开发者可以根据自己的需要请求用户不同信息的授权。具体可以获取的授权信息参见1.2获取用户授权参数说明。 在设置完需要请求的授权信息之后,就可以发送请求了(备注:inSafari参数从iOS SDK1.3版本后废除)。 NSArray* permissions = [NSArray arrayWithObjects:kOPEN_PERMISSION_GET_USER_INFO,kOPEN_PERMISSION_GET_SIMPLE_USER_INFO,kOPEN_PERMISSION_ADD_SHARE,nil]; TencentOAuth *_tencentOAuth = [TencentOAuth initWithAppid:appid andDelegate:delegate]; [_tencentOAuth authorize:permissions inSafari:NO]; 其中_tencentOAuth为TencentOAuth类的实例。 获取用户授权结果 获取用户授权结果,采用的是代理回调的方式,所以开发者需要实现TencentLoginDelegate协议,登录结果分为三种:登录成功、登录失败和登录取消。 - (void)tencentDidLogin; // 登录成功后的回调 - (void)tencentDidNotLogin:(BOOL)cancelled; // 登录失败后的回调 - (void)tencentDidNotNetWork; // 登录时网络有问题的回调 如果登录成功,则开发者可以通过实现TencentLoginDelegate
- 游戏内加好友及绑群
1. 游戏添加好友 QQApiAddFriendObject *object = [[QQApiAddFriendObject alloc] initWithOpenID:@"A57597D3BA6F31A0F5D0049A354756FC"]; object.description = @"一起玩游戏吧"; object.subID = @"1234"; object.remark = @"备注这里填写"; SendMessageToQQReq* req = [SendMessageToQQReq reqWithContent:object]; QQApiSendResultCode sent = [QQApiInterface sendReq:req]; 注意事项: APPID要有添加好友的权限 2.游戏公会 错误码定义: GuildErrorCode 说明 GuildErrNone GuildErrNet 网络错误, 请求失败 GuildErrLocalApi 调用本地接口错误, 具体错误码见回调QQApiSendResultCode GuildErrLocalParamsInvalid 本地参数错误 GuildErrInvalidLogin 无效的登录状态 GuildErrExistBind已有绑定群 逻辑错误 GuildErrNonExistBind 未绑定群 逻辑错误 GuildErrInvalidGrpOwner 当前用户不是群主 GuildErrParamsInvalid 参数无效 GuildErrInvalidRight 该app无接口调用权限 GuildErrInvalidMember 不是公会成员 GuildErrOverGrpCout 达到创建群上限 GuildErrOverCreateGrp 创建群频率过高 GuildErrGrpDeleted 群被删除了 GuildErrOther 其他错误 注意:下面的cgi调用都需要有登录态!! 2.1 绑定公会和QQ群 TCGuildBindGroupDic *info = [[TCGuildBindGroupDic alloc] init]; info.paramRoleId = @"
- 解除绑群
解绑群 通过调用Tencent类的unBindGroup调用解绑群接口 API格式: unBindGroup(Context context, Bundle params, IUiListener listener) 参数1 Context: 上下文 参数2 Bundle:外部传递参数 参数 是否必填 类型 参数说明 GameAppOperation.GAME_GUILD_ID 是 String 公会ID GameAppOperation.GAME_GUILD_ZONE_ID 是 String 游戏区域ID GameAppOperation.GAME_ROLE_ID 是 String 游戏角色ID 参数3 IUiListener 回调实例。 返回码 0: 成功 221002: 未绑定群 221005: 当前用户不是群主 调用接口的示例代码如下: mTencent = Tencent.createInstance(APPID, this); Bundle params = new Bundle(); params.putString(GameAppOperation.GAME_GUILD_ID, guild_id.getText()); params.putString(GameAppOperation.GAME_GUILD_ZONE_ID , zone_id.getText()); params.putString(GameAppOperation.GAME_ROLE_ID, role_id.getText()); IUiListener listener = new IUiListener() { @Override public void onComplete(Object response) { Util.toastMessage(this, “onComplete:” + response.toString()); JSONObject jsonObject = (JSONObject )response; try{ String retMsg = jsonObject.getString(“retMsg”); int retCo
- 查询工会是否绑定群
查询公会是否绑定群 通过调用Tencent类的checkBindGroup调用查询公会是否绑定群接口 API格式: checkBindGroup(Context context, Bundle params, IUiListener listener) 参数1 Context: 上下文 参数2 Bundle:外部传递参数 参数 是否必填 类型 参数说明 GameAppOperation.GAME_GUILD_ID 是 String 公会ID GameAppOperation.GAME_GUILD_ZONE_ID 是 String 游戏区域ID GameAppOperation.GAME_ROLE_ID 是 String 游戏角色ID 参数3 IUiListener 回调实例。 成功:返回码为0并且群号不为空。 调用接口的示例代码如下: mTencent = Tencent.createInstance(APPID, this); Bundle params = new Bundle(); params.putString(GameAppOperation.GAME_GUILD_ID, guild_id.getText()); params.putString(GameAppOperation.GAME_GUILD_ZONE_ID , zone_id.getText()); pparams.putString(GameAppOperation.GAME_ROLE_ID, role_id.getText()) IUiListener listener = new IUiListener() { @Override public void onComplete(Object response) { Util.toastMessage(this, “onComplete:” + response.toString()); JSONObject jsonObject = (JSONObject )response; try{ String retMsg = jsonObject.get(“retMsg”); String retCode = jsonObject.get(“retCod
- 一键加群功能
一键加群 通过调用Tencent类的gameBindGroup调用绑定群接口,参数如下: Params: Bundle类型调用参数,必须包含的参数含义如下: 参数 是否必填 类型 参数说明 GameAppOperation.GAME_GUILD_ID 是 String 公会ID GameAppOperation.GAME_GUILD_ZONE_ID 是 String 游戏区域ID GameAppOperation.GAME_ROLE_ID 是 String 游戏角色ID 调用接口的示例代码如下: mTencent = Tencent.createInstance(APPID, this); Bundle params = new Bundle(); params.putString(GameAppOperation.GAME_GUILD_ID, guild_id.getText()); params.putString(GameAppOperation.GAME_GUILD_ZONE_ID , zone_id.getText()); params.putString(GameAppOperation.GAME_ROLE_ID, role_id.getText()); mTencent.gameBindGroup(this, params); 注意:CGI调用需要登录态!!!
- 查询公会id和成员openid关系
查询公会id和成员openid关系 通过调用Tencent类的 checkJoinGroup调用解绑群接口 API格式: checkJoinGroup(Context context, Bundle params, IUiListener listener) 参数1 Context: 上下文 参数2 Bundle:外部传递参数 参数 是否必填 类型 参数说明 GameAppOperation.GAME_UNION_ID 是 String 公会ID GameAppOperation.GAME_ZONE_ID 是 String 游戏区域ID 参数3 IUiListener 回调实例。 返回码 0: 成功 221002: 未绑定群 221005: 当前用户不是群主 调用接口的示例代码如下: mTencent = Tencent.createInstance(APPID, this); Bundle params = new Bundle(); params.putString(GameAppOperation.GAME_GUILD_ID, guild_id.getText()); params.putString(GameAppOperation.GAME_GUILD_ZONE_ID , zone_id.getText()); IUiListener listener = new IUiListener() { @Override public void onComplete(Object response) { Util.toastMessage(this, “onComplete:” + response.toString()); JSONObject jsonObject = (JSONObject )response; try{ String retMsg = (String)jsonObject.getString(“retMsg”); int retCode = (Integer)jsonObject.getInt(“retCode”); int relation = (Integer)jsonObject.getInt(“relat
- 游戏应用接入概述
1. 游戏应用接入介绍 QQ互联开放平台为开发者提供了丰富的API。游戏应用接入QQ互联开放平台后,即可通过调用平台提供的API实现用户使用QQ帐号登录网站功能,且可以获取到腾讯QQ用户的相关信息。 开发者也可以调用腾讯方提供的API实现网站的分享、评论、邀请等功能,即游戏的社交化功能。且可以将相关信息同步到QQ空间、兴趣部落、QQ群等平台,建立游戏与腾讯各平台的互动关系,利用庞大的QQ用户群来实现网站的快速传播。 游戏接入QQ互联开放平台后,您将获得: 海量新用户:用户使用已有的QQ号码即可登录网站,QQ一键登录更可减少登录交互操作,大大降低网站注册门槛,给网站带来海量新用户。 活跃的访问量:已登录用户可以将在网站上发布、分享的信息即时同步到QQ空间,使网站内容通过QQ好友关系链得到进一步的传播,从而提升网站的访问量。 丰富的开放API:网站可以通过用户资料接口获取用户的空间昵称和头像,来丰富用户注册资料。此外,还可以通过说说,相册,日志等开放接口使用户直接在网站上访问或修改他们在QQ空间、腾讯朋友、腾讯微博上的数据,与腾讯各平台实现更进一步的互联互通。 2. 游戏应用接入方式 第三方网站主要通过使用“QQ登录”接入QQ互联开放平台。 “QQ登录”是QQ互联开放平台提供给第三方网站的一种服务。 “QQ登录”可以让用户使用QQ帐号在游戏应用上登录,分享内容、同步信息,大大降低了用户注册的门槛。 同时,开发者根据用户提供的绑定信息,将用户在网站上发布的内容同步发布到QQ空间的个人动态中,从而借助QQ空间庞大的用户群,使应用的信息能通过好友关系得到进一步的传播,提升游戏的用户活跃度和用户数。 3. 使用QQ登录效果展示 下面描述了一个网站使用“QQ登录”,并访问和修改QQ用户个人信息的整个过程。 注意: 这里的描述意在简单的向游戏开发者演示接入“QQ登录”需要进行哪些工作,以及效果如何。 3.1 游戏上设置QQ登录入口 网站开发者可以在自己的游戏登录页面上放置显著的“QQ登录”标识。 如下图所示: 3.2 用户选择用QQ帐号登录 用户点击按钮之后弹出QQ登录的窗口,在登录窗口中将显示游戏自己的Logo标识,游戏名称。 如下图所示: 如果用户已登录QQ软件,就不用重复输入帐号密码,可以一键实现快速登录并且可以选择授权允许游戏访问自己的相
- 常见问题
1.相同开发者账号下的不同appid应用如何打通?(应用打通) 使用UnionID作为识别同一用户的唯一标识,即同一开发者登录不同应用返回相同UnionID,开发者需发送邮件申请UnionID接口权限。相关申请表格下载填写后请以邮件形式进行申请提交,详见→【相关申请表格下载】 2.我的网站在海外,没有ICP运营许可证号,可以申请吗?(国际域名审核) 可以。 在页面正确填写网站资料并提交申请后,便可以立即获取QQ登录相关的appkey和appid,无需等待审核。相关申请表格下载填写后请以邮件形式进行申请提交,详见→【相关申请表格下载】 3.我的网站应用需要迁移到另一个qq号码里。如何操作?(应用开发者转移) 可到“管理中心”的控制台进行转移。 如原管理QQ号或密码已遗忘或丢失,请提供appid、密钥(appkey)、需要转移到的新QQ号、营业执照、网站备案复印件发到connect@qq.com申请转移,移动应用需要到腾讯开放平台进行迁移。相关申请表格下载填写后请以邮件形式进行申请提交,详见→【相关申请表格下载】 4.与其它网站的登录接入是否有冲突? QQ登录使用国际通用的的OAuth2.0协议进行验证与授权,第三方网站访问腾讯的用户信息时,使用的是腾讯公司为网站分配的access token,因此第三方网站与其它网站的登录接入并不受影响。 详见:OAuth2.0开发文档。 5.没开空间的QQ号码登录的时候不能自动跳转到网站?有别的解决方案吗? 目前只能建议用户开通QQ空间。后续腾讯会优化这里的体验,非开通用户也能够正常使用QQ登录来登录网站。 6. 为什么用户用QQ帐号登录部分网站不能一键登录,还需要再输入用户名和邮箱? 这个与网站自身逻辑有关。一般来说用户第一次使用QQ帐号登录网站时,网站需要用户输入用户名和密码来实现QQ帐号和网站自身帐号的绑定。 7.登录分享图标不正确如何处理? 请您确认以下两点信息: (1)确定用户应用代码中的appid是否配置正确(应用图标是根据appid来拉取后台的图标数据的); (2)确定用户本地QQ缓存是否清理(QQ客户端会存储图标缓存,并不是实时拉取,更换手机设备或清除QQ缓存测试一下)。 8.为什么QQ分享出去的内容无法显示? 这个是由于您分享的链接在空间大量恶意传播,诱导分享,被大量用户举报导致的。功能
- 申请注册相关问题
1. 我的网站使用QQ登录会有什么样的好处? 海量新用户:用户使用已有QQ号码即可登录网站,QQ一键登录更可减少登录交互操作,大大降低网站注册门槛,给网站带来海量新用户。 活跃的访问量:已登录用户可以将在网站上发布、分享的信息即时同步到QQ空间,使网站内容通过QQ好友关系链得到进一步的传播,从而提升网站的访问量。 丰富的开放API:网站可以通过用户资料接口获取用户的空间昵称和头像,来丰富用户注册资料。此外,还可以通过说说,相册,日志等开放接口使用户直接在网站上访问或修改他们在QQ空间上的数据,与QQ空间实现更以进一步的互联互通。 详见:网站接入概述。 2. 如何申请? 在“管理中心”页面注册为开发者,创建网站/应用。 添加成功后,在管理中心的应用列表中即可看到该应用,以及对应的appkey和appid等信息。 3. 申请QQ登录需不需要审核?申请处理的时间一般为多长? 需要通过审核。创建应用后便可以立即获取QQ登录相关的appkey和appid。审核过程大约5个工作日,未审核通过的appid只能使用注册的QQ号码进行测试登录,审核通过的可以全量使用。 4. 未审核通过,会产生怎样的限制? 为了保障QQ用户登录第三方的安全性,避免违法站点/应用频繁调用QQ用户信息,并大量发送信息以致骚扰到其他好友群体,QQ互联平台对审核未通过的第三方应用采取”仅开发者帐号能登录”的限制。对此造成的不便,请您谅解。 5. 申请QQ登录时提示“网站域名验证失败”? 验证失败可能由于以下原因导致: ①验证代码未添加成功,请查看验证代码是否已成功添加到网站的HEAD标签中。 ②添加的验证代码与当前登录QQ号不匹配,不同QQ号进行验证时生成的验证码不同,请确认当前进行验证的QQ号生成的验证码与添加到网页源代码里的相同。 6. 回调地址常见问题及修改方法 请参见回调地址常见问题及修改方法。 7.如何验证openid的正确性? 拿到token和openid传到自己服务器,然后在服务侧调用下面接口验证openid的正确性。 https://graph.qq.com/oauth2.0/me?access_token=YOUR_ACCESS_TOKEN 8. 申请QQ登录后,接下来怎么做? 根据开发攻略进行QQ登录相关的开发工作: 网站应用接入概述| 移动应用接入
- Android_SDK环境搭建
1. 搭建开发环境 以下以eclipse为开发的IDE进行范例说明: (1)创建一个工程,并把open-sdk.jar文件和mta_sdk_x.x.x.jar文件拷贝到libs(或lib)目录下,如下图所示: (2)将open-sdk.jar加入编译路径中。 具体的操作步骤为:选中open-sdk.jar,右键菜单中选择Build Path, 选择Add to Build Path,如下图所示: (3)将mta_sdk_x.x.x.jar加入编译路径中。 按照上面的方法,将mta_sdk_x.x.x.jar加入编译路径中。 在工程的Referenced Libraries目录下看到导入的jar包,说明已经成功将jar包加入build path,如下图所示: (4)配置AndroidManifest; 在应用的AndroidManifest.xml增加配置的<application>节点下增加以下配置(注:不配置将会导致无法调用API); <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <application> <activity android:name="com.tencent.tauth.AuthActivity" android:noHistory="true" android:launchMode="singleTask" > <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.cat
- 成为开发者
开发者通过以下几个步骤,即可接入互联开放平台: 注册开发者→创建应用→通过审核并获取接口权限 1.注册开发者 1. 在QQ互联开放平台首页 https://connect.qq.com/ ,点击右上角的“登录”按钮,使用QQ帐号登录,如下图所示: 重要提示: 开发者QQ号码一旦注册不能变更,建议使用公司公共QQ号码而不是员工私人号码注册,以免遇到员工离职等情况造成不必要的麻烦。 2. 登录成功后会跳转到开发者注册页面,在注册页面按要求提交公司或个人的基本资料。下图所示的是公司注册页面: 3.按要求提交资料后,审核人员会进行审核,通过审核即可成为开发者。
- 网站应用接入概述
1. 网站应用接入介绍 QQ互联开放平台为第三方网站提供了丰富的API。第三方网站接入QQ互联开放平台后,即可通过调用平台提供的API实现用户使用QQ帐号登录网站功能,且可以获取到腾讯QQ用户的相关信息。 第三方网站也可以调用腾讯方提供的API实现网站的分享、评论、邀请等功能,即网站的社交化功能。且可以将相关信息同步到QQ空间、腾讯朋友、腾讯微博等平台,建立网站与腾讯各平台的互动关系,利用庞大的QQ用户群来实现网站的快速传播。 网站接入QQ互联开放平台后,您将获得: 海量新用户:用户使用已有的QQ号码即可登录网站,QQ一键登录更可减少登录交互操作,大大降低网站注册门槛,给网站带来海量新用户。 活跃的访问量:已登录用户可以将在网站上发布、分享的信息即时同步到QQ空间,使网站内容通过QQ好友关系链得到进一步的传播,从而提升网站的访问量。 丰富的开放API:网站可以通过用户资料接口获取用户的空间昵称和头像,来丰富用户注册资料。此外,还可以通过说说,相册,日志等开放接口使用户直接在网站上访问或修改他们在QQ空间、腾讯朋友、腾讯微博上的数据,与腾讯各平台实现更进一步的互联互通。 2. 网站应用接入方式 第三方网站主要通过使用“QQ登录”接入QQ互联开放平台。 “QQ登录”是QQ互联开放平台提供给第三方网站的一种服务。 “QQ登录”可以让用户使用QQ帐号在第三方网站上登录,分享内容、同步信息,大大降低了用户注册的门槛。 同时,第三方网站根据用户提供的绑定信息,将用户在网站上发布的内容同步发布到QQ空间的个人动态中,从而借助QQ空间庞大的用户群,使网站的信息能通过好友关系得到进一步的传播,提升网站的访问量和用户数。 3. 使用QQ登录效果展示 下面描述了一个网站使用“QQ登录”,并访问和修改QQ用户个人信息的整个过程。 注意: 这里的描述意在简单的向网站开发者演示接入“QQ登录”需要进行哪些工作,以及效果如何。 3.1 网站上设置QQ登录入口 网站开发者可以在自己的网站首页入口和主要的登录、注册页面上放置“QQ登录”标识(见红色方框标记处) 3.2 用户选择用QQ帐号登录 用户点击按钮之后弹出QQ登录的窗口,在登录窗口中将显示网站自己的Logo标识,网站名称以及首页链接地址。 如下图所示: 如果用户已登录QQ软件,就不用重复输入帐号密码,可以一键实现
- 联系我们
开发者在遇到QQ互联平台相关问题时,也可以尝试与互联团队通过邮件来进行反馈,QQ互联平台的邮箱为:connect@qq.com QQ互联平台将在收到邮件后尽快处理你的反馈。 由于邮箱的邮件数量巨大,请将你的邮件标题(主题)按照以下格式命名,填写对应表格,我们会优先处理分类清晰、问题叙述清楚的反馈。 邮件标题:【问题类别】问题的简述 例如:【应用打通】腾讯公司应用打通 问题类别包括: 1.应用打通 【申请表格下载】 2.国际域名接入QQ互联 【申请表格下载】 3.应用开发者转移 【申请表格下载】 4.其他问题咨询
- 创建应用
网站应用及移动应用接入申请 应用接入前,首先需进行申请,获得对应的appid与appkey,以保证后续流程中可正确对网站与用户进行验证与授权。 1.1 创建应用 开发者注册完成后,点击“应用管理”按钮。 跳转到qq互联管理中心页面,点击创建应用。 选择需要创建的应用类型,我们以网站应用为例: 点击创建网站应用后,按要求完善信息: 网站回调地址填写规范:https://wiki.connect.qq.com/%E5%9B%9E%E8%B0%83%E5%9C%B0%E5%9D%80%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E5%8F%8A%E4%BF%AE%E6%94%B9%E6%96%B9%E6%B3%95 备案信息填写规范:http://www.miitbeian.gov.cn/publish/query/indexFirst.action 网站信息填写完成,点击“创建应用”后,网站应用创建完成,点击“应用管理”,进入管理中心,在管理中心可以查看到网站获取的appid和appkey,如下图所示: 备注:创建移动应用与网站应用步骤方法一致,在此不赘述。 1.2 网站信息完善 点击“应用中心”,应用右侧的“查看”,进入应用详情页面。 应用详情页面可点击“修改”来编辑应用“基本信息”和“平台信息”。 点击“应用接口”可查看已获取的接口,使用QQ登录功能。
- 网站前端页面规范
1. 使用腾讯提供的标准“QQ登录”标识 腾讯提供了下面几种标准的“QQ登录”标识,供开发者下载使用。 下载方式: 将鼠标移到所需的图片上,点击右键选择“图片另存为...”,保存即可。 注意: 1. 我们不提供包含所有规格标识的图片包下载,请开发者根据需要选择合适的标识下载。 2. 以下各种规格的图标版权都归腾讯公司所有,请勿更改,否则腾讯公司有权单方面中止QQ登录连接服务。 1.1 QQ登录长图标 大小 标示 230*48 170*32 120*24 105*16 1.2 QQ登录中图标 大小 标示 63*24 50*16 1.3 QQ登录小图标+文字链接 大小 标示 16*16 QQ登录 2. 标识放置位置规范 2.1 放置准则 “QQ登录”按钮放置的位置必须易于用户查找,即在网站界面上可以很容易找到“QQ登录”标识。 2.2 建议的放置位置 建议放置在登录页以及注册页,如下图所示(见红色方框标注处): 1. 放置在登录页的例子: 2. 放置在注册页的例子: 2.3 中/小规格“QQ登录”标识旁,建议添加文字说明 在放置中/小规格“QQ登录”标识的按钮旁,建议增加说明文字。 例如:“QQ登录”“QQ帐号登录”等字样。 说明文字将有利于增加QQ用户对该功能的认知,以提升潜在的将网站与QQ空间连接的用户数。 3. 用户引导规范 3.1 对初次使用“QQ登录”成功登录网站的用户提供欢迎页面 当用户第一次使用“QQ登录”登录网站,并完成授权以后,网站需提供欢迎页面对用户进行引导。 建议在欢迎页上显示用户QQ空间的昵称和头像以及登录途径,有利于提升用户体验。 如下图所示: 3.2 帐号绑定时,使用一键开通的方式开通新帐号 用户首次使用“QQ登录”成功登录网站后,可以引导用户在帐号绑定对话框里授权将QQ帐号与网站帐号绑定。 如果用户没有该网站帐号,则需在对话框里进行简单的注册。 在这里,强烈建议使用一键开通的方式开通新帐号,而无需提供其它注册资料。如下图所示: 3.3 帐号绑定时,使用户的操作量最小化 在引导用户将网站与空间连接的过程中,如果必须用户提供额外信息,强烈建议使用户的操作量最小化,或者在连接成功以后使用其他方式引导用户完善资料。 3.4 帐号绑定成功
- 重要更新
更新时间 详细说明 2018-08-01 QGSK 安卓端新增登录时上报渠道的接口。详情请见SDK下载页面 2018-05-24 QQ互联iOS_SDK_V3.3.3及 Android_SDK_V3.3.3发布。详情请见SDK下载页面 2018-02-27 [通知]互联加强网站应用回调地址校验通知,详情点此查看 2018-02-11 [通知]用户基本信息中的用户头像URL域名变更通知,详情点此查看 2018-01-24 [通知]QQ互联在移动端上只支持QQ/TIM授权登录,详情点此查看 2018-01-22 QQ互联iOS_SDK_V3.3.1及 Android_SDK_V3.3.1 发布。1.支持ARK分享能力;2.增加unionID查询接口;3.增加token缓存能力;4.修改部分bug及安全改进详情请见SDK下载页面 2018-01-22 各平台SDK内附有对应版本的demo及开发文档,开发者可参考源代码完成开发,安全、便捷地在App中实现QQ登录、分享等功能。 2017-09-14 QQ互联开放QQ手游手游运营能力,新增加绑群及支付和兴趣部落相关功能。详情请见SDK下载页面。详情请见SDK下载页面 2012-11-30 QQ互联统一升级到OAuth2.0版本。查看详细
- iOS_SDK_API_使用说明
1. SSO安全登录QQ帐号 iOS SDK支持应用跳转到手机QQ进行登录,给用户提供更加安全、快捷的体验 。如果用户没有安装手机QQ,将打开登录页面。 2. 分享到QQ和QQ空间 2.1 分享到QQ好友 分享到QQ好友支持发送: - 纯文本消息(QQApiTextObject) - 纯图片消息(QQApiImageObject) - 新闻类消息(QQApiNewsObject) - 音频类消息(QQApiImageObject) - 视频类消息(QQApiVideoObject) 在用户安装了手机QQ时通过手机QQ进行分享,否则调用浏览器页面进行分享。 其中文本消息,图文消息和音频消息的title是必须的,summary可以不填,具体调用请参考2.3 分享示例代码。 使用分享到QQ好友功能需要设置QQ业务回调,请参考6. 处理QQ业务的回调。 2.2 分享到QQ空间 分享到QQ空间的接口用于取代老的分享接口addShareWithParams(该接口已经废弃)。 分享到QQ空间支持发送: - 带有URL的消息 - 新闻类消息(QQApiNewsObject) - 音频类消息(QQApiImageObject) - 视频类消息(QQApiVideoObject) 分享时调用浏览器页面进行分享。其中title是必须的,summary可以不填,具体调用请参考2.3 分享示例代码。 使用分享到QQ空间功能需要设置QQ业务回调,请参考6. 处理QQ业务的回调。 2.3 分享示例代码 下面是各种分享消息的实例代码,作为开发者调用QQ好友分享和QQ空间分享的参考: 纯文本分享: QQApiTextObject *txtObj = [QQApiTextObject objectWithText:@"QQ互联测试"]; SendMessageToQQReq *req = [SendMessageToQQReq reqWithContent:txtObj]; //将内容分享到qq QQApiSendResultCode sent = [QQApiInterface sendReq:req]; 纯图片分享: NSString *imgPath = [[[NSBundle mainBundle] resourcePath] stringByAppen
- iOS_SDK环境搭建
QQ登录iOS SDK 封装了QQ登录的登录授权以及大部分OpenAPI,应用只需要修改相应参数,不需要理解验证授权流程,即可快速实现QQ登录功能。 iOS平台上(iPad,iPhone,iPod)的应用,请在申请appid,appkey后,使用QQ互联提供的iOS SDK。 1.5版本增加 QQAPI 对象,以支持手机QQ的调用。以前申请过 APPID 类似“QQXXXXXXXX”的开发商,建议重新申请。为了兼容旧版本的手机QQ,需要增加 URL Scheme,QQ + 十六进制新AppId,不足八位在首部补0。(如 appid=222222 则 scheme=QQ0003640E) 详情请参考iOS_SDK_API_使用说明 本SDK仅适用于移动应用,即基于使用Implicit_Grant方式获取Access_Token接入的应用。 变更历史 V2.0.1 增加全新的分享到QZone的接口 V2.0 新增API判断手机QQ版本 新增WPA临时会话 支持分享音频消息 Demo 实现简单调整 分享消息结构化改造 新增系统库Security.framework 1. iOS SDK 下载 请到SDK下载页面下载最新版本QQ登录iOS SDK。 2. iOS SDK目录结构 iOS SDK包中带有两个文件: 1. TencentOpenAPI.framework打包了iOS SDK的头文件定义和具体实现。 2. TencentOpenApi_iOS_Bundle.bundle 打包了iOS SDK需要的资源文件。 3. 将iOS SDK文件添加到工程中 1. 将iOS SDK中的TencentOpenAPI.framework和TencentOpenApi_IOS_Bundle.bundle文件拷贝到应用开发的目录下。 然后将TencentOpenAPI.framework从SDK的保存目录拖拽到工程导航视图(project navigator)中的Frameworks虚拟目录下。 注意TencentOpenAPI.framework和TencentOpenApi_IOS_Bundle.bundle必须放到应用的资源的根目录下,否则会出现资源无法加载的问题。 2. 在弹出的对话框中勾选“Create groups for
- iOS应用接入概述
QQ互联移动接入iOS SDK 2.0.0 (2013 - 10 - 30) 更新内容: 1.QQ分享支持网络图片和音乐分享 2.新增获取WPA用户在线状态和发起WPA会话的接口。 3.新增判断手机QQ版本接口 1. iOS开发视频教程 视频演示使用SDK进行QQ登录、分享消息到QQ、设置QQ头像等功能的开发过程 2. iOS SDK环境搭建 简单的教程让您快速熟悉SDK的使用 3. iOS SDK API使用说明 详细的文档让你轻松的调用SDK接口
- 视觉素材下载
1. 视觉素材下载 1.1 QQ LOGO 01_qq_logo 预览: PSD文件下载: 点此下载 02_qq_logo_ver 预览: PSD文件下载: 点此下载 03_qq_symbol 预览: PSD文件下载: 点此下载 1.2 Qzone相关素材 Qzone LOGO 蓝色背景预览: 黑色背景预览: 白色背景预览: PSD文件下载: https://qzonestyle.gtimg.cn/qzone/vas/opensns/res/doc/Qzone_logo_3color.psd Qzone 图标 预览: PSD文件下载: https://qzonestyle.gtimg.cn/qzone/vas/opensns/res/doc/Qzone_logo_icon_wiki.psd 1.3 QQ分享相关素材 预览: PSD文件下载: https://qzonestyle.gtimg.cn/qzone/vas/opensns/res/doc/icon_for_ios7.psd 2. QQ登录框标准样式 下载方式:鼠标移到需要下载的图片素材上方,点击右键,选择“图片另存为...”,保存至本地文件夹即可。 参考图标: (大图标 92*120) (蓝色76*24) (灰色76*24) (蓝色24*24) (灰色24*24) 3. 关于功能组件样式 QQ互联的功能组件样式在各个组件介绍页面已经提供了多种样式,建议您在功能组件调用页面中选择。 4 版权声明 QQ互联为开发者提供的标准视觉素材,仅供开发应用使用。 腾讯公司对其发行的或与合作公司共同发行的包括但不限于产品或服务的全部内容及腾讯网站上的材料拥有版权等知识产权,受法律保护。 未经本公司书面许可,任何单位及个人不得以任何方式或理由对上述产品、服务、信息、材料的任何部分进行使用、复制、修改、抄录、传播或与其它产品捆绑使用、销售。 凡侵犯本公司版权等知识产权的,本公司必依法追究其法律责任。
- Android应用常见问题-update
1.客户端获取的openid是正确的,再通过客户端把openid传给我们的服务器,我们服务器怎么验证这是正确的openid? 可以拿到token和openid传到自己服务器,然后在服务侧调用下面接口验证openid的正确性。 https://graph.qq.com/oauth2.0/me?access_token=YOUR_ACCESS_TOKEN 2.您好,在管理中心上传过图标,但显示的还是旧图标,怎么办? 1. 确定用户应用代码中的appid是否配置正确( 2. 3. 是根据appid来拉取后台的图标数据的); 2. 检查CDN服务器图标是否正确(应用状态必须是使用中,为提交审核的应用图标缓存是分批逐步同步的外网环境中的); 3. 确定用户本地QQ缓存是否清理(QQ客户端会存储图标缓存,并不是实时拉取,更换手机设备或清除QQ缓存测试一下); 3.客户端获取的openid是正确的,再通过客户端把openid传给我们的服务器,我们服务器怎么验证这是正确的openid? 可以token和openid去调用接口拉取用户资料, 看能不能正常拉到用户资料。 4.我的在调试的时候QQ登录不能用了提示110406? 使用的QQ未添加到应用调试者。 5.通过腾讯sdk怎么判断手机是否安装了QQ呢?我现在需要判断手机是否安装了QQ,如果没安装就不让分享。 没有专门的函数可以判断是否安装了QQ,可以使用包名进行判断。 6.用QQ互联分享到QQ空间,分享的图片link是固定地址的,后来图片更换了一个,但是现在分享出去在QQ空间还显示老图? 分享出去后图片地址会被替换掉,技术上,只能换url了,或者加个后缀,终端就匹配不到,会下载新的。开发商已修改URL。 7.你们qq分享在消息框下面显示的应用名字,是怎么来的? 这个名称是开发商自己配置的(app_name),从2.9.5版本以后应用名字开始根据appid从后台拉取。 8.移动APP获取token,openid接入服务端问题? 把获取到的token, openid打包上传到服务器, 移动端去拉取资料自己给自己上传,然后用这个网页来验证正确性 https://graph.qq.com/oauth2.0/me?accesstoken=YOURACCESS_TOKE
- com.tencent.tauth.Tencent.invite
特别声明: 出于信息安全的考虑,本接口仅对可信赖的合作应用开放。已经成功接入“QQ登录”的应用需提交申请以获取访问本接口的权限。 1. 接口说明 邀请好友的基本流程为: (1)判断用户是否已经登录,且应用是否获取了openid; (2)创建一个Bundle,并填入必要参数; (3)调用SDK中Tencent类的invite接口,启动邀请界面。 2. 使用场景 用户邀请QQ好友使用该应用。 3. 接口调用说明 3.1 接口方法 int com.tencent.tauth.Tencent.invite(Activity arg0, Bundle arg1, IUiListener arg2) 3.2 参数说明 Bundle参数 是否必传 类型 参数说明 Constants.PARAM_APP_ICON 必传 String 邀请弹框中显示的应用图标的URL。 Constants.PARAM_APP_DESC 必传 String 邀请弹框中显示的邀请内容。 Constants.PARAM_SOURCE 可选 String 由开发者自定义该参数内容,用于判断好友来源。邀请成功后,被邀请方通过邀请链接进入应用时会携带该参数并透传给应用。 3.3 示例代码 private void onClickInvite() { if (mTencent.isSessionValid()&& mTencent.getOpenId() != null) { Bundle params = new Bundle(); String icon_url = "http://imgcache.qq.com/qzone/space_item/pre/0/66768.gif"; String invite_msg ="AndroidSdk_1_3: invite description!"; params.putString(Constants.PARAM_APP_ICON, icon_url); params.putString(Constants.PARAM_APP_DESC, invite_msg); mTencent.invite(this, params, new MyUiListener());
- com.tencent.tauth.Tencent.shareToQQ
1. 接口说明 分享消息到QQ的接口,可将新闻、图片、文字、音乐享给QQ好友、群和讨论组。 Tencent类的shareToQQ函数可直接调用,不用用户授权。调用将打开分享的界面,用户选择好友、群或讨论组之后,点击确定即可完成分享,并进入与该好友进行对话的窗口。 1.1接口方法 void com.tencent.tauth.Tencent.shareToQQ(Activity activity, Bundle params, IUiListener listener) 本接口支持3种模式,每种模式的参数设置不同。 2. 分享图文消息 分享图文消息:可以同时发送文字、图片和网络连接,适合分享新闻、应用推荐。 Bundle 参数 是否必传 类型 参数说明 Tencent.SHARE_TO_QQ_KEY_TYPE 必选 int 分享的类型。图文分享(普通分享)填 Tencent.SHARE_TO_QQ_TYPE_DEFAULT Tencent.PARAM_TARGET_URL 必选 String 这条分享消息被好友点击后的跳转URL。 Tencent.PARAM_TITLE 必选 String 分享的标题, 最长30个字符。 Tencent.SHARE_TO_QQ_IMAGE_URL 可选 String 分享的图片URL。 Tencent.PARAM_SUMMARY 可选 String 分享的消息摘要,最长40个字符。 Tencent.SHARE_TO_QQ_APP_NAME 可选 String 手Q客户端顶部,替换“返回”按钮文字,如果为空,用返回代替 Tencent.SHARE_TO_QQ_EXT_INT 可选 int 分享额外选项,两种类型可选(默认是不隐藏分享到QZone按钮且不自动打开分享到QZone的对话框): Tencent.SHARE_TO_QQ_FLAG_QZONE_AUTO_OPEN,分享时自动打开分享到QZone的对话框。 Tencent.SHARE_TO_QQ_FLAG_QZONE_ITEM_HIDE,分享时隐藏分享到QZone按钮 示例代码 //分享图文消息 private void onClickShare() { final Bundle params = new Bundle();
- com.tencent.tauth.Tencent.getAppFriends
1. 接口说明 通过调用Tencent类的getAppFriends函数实现获取应用内好友的功能,其中应用内好友指的是已安装该应用的QQ好友。 2. 使用场景 此接口主要使用于获取安装该应用的好友列表 3. 接口调用说明 3.1 接口方法 void com.tencent.tauth.Tencent.getAppFriends(IRequestListener arg0) 3.2 参数说明 listener是IRequestListener的实例,关于IRequestListener的说明可参考《创建并实现回调》。 3.3 示例代码 private void onClickGetAppFriends() { if (mTencent.isSessionValid() && mTencent.getOpenId() != null) { mTencent.getAppFriends(new BaseApiListener()); } } 3.4 返回码说明 0: 正确 其它: 失败 OpenAPI公共错误码说明详见:Android常见问题及公共返回码说明。
- com.tencent.tauth.Tencent.challenge
1. 接口说明 通过调用Tencent类的challenge函数发送挑战信息。 2. 使用场景 用户可以向安装了同一应用的其他用户发起挑战。 3. 接口调用说明 3.1 接口方法 int com.tencent.tauth.Tencent.challenge(Activity arg0, Bundle arg1, IUiListener arg2) 3.2 参数说明 Bundle 参数 是否必传 类型 参数说明 Constants.PARAM_RECEIVER 必传 String 炫耀/挑战的用户的openid,应用传入的openid必须为当前用户的QQ好友且对方必须为已安装用户。 Receiver只能为1个,每天针对同一个好友只能挑战/炫耀一次 Constants.PARAM_SEND_MSG 必传 String 炫耀/挑战中的内容描述。长度限制:50个汉字(100个字符)以内,超过限制则自动从末尾截断 Constants.PARAM_IMG_URL 必传 String 炫耀/挑战场景图的URL Constants.PARAM_SOURCE 可选 String 透传参数,由开发者自定义该参数内容。开发者可根据这个参数的内容,判断被炫耀/挑战的用户是点击哪个好友发送的信息。例如:用户A向C发送炫耀/挑战信息时,source的值为“openid=001”,用户B向C发送炫耀/挑战信息时,source的值为“openid=002”。当用户C点击信息链接进入应用时,url中会携带app_custom参数,如果app_custom的值为“openid=001”,说明C点击的信息是A发送的,如果app_custom的值为“openid=002”,说明C点击的信息是B发送的。 3.3 示例代码 private void onClickChallenge() { if (mTencent.isSessionValid() && mTencent.getOpenId() != null) { String friendUid = "15762FF138EE42D88FE2234D3B89C44B"; String imgUrl = "http://i.gtimg.cn/qzonestyle/act/qzone_app_
- com.tencent.tauth.Tencent.ask
1. 接口说明 给应用好友发送请求、赠送礼物 2. 使用场景 用户可以向安装了同一应用的好友发起请求或者赠送礼物 3. 接口调用说明 3.1 接口方法 1)发送请求 int com.tencent.tauth.Tencent.ask(Activity arg0, Bundle arg1, IUiListener arg2) 2)赠送礼物 int com.tencent.tauth.Tencent.gift(Activity arg0, Bundle arg1, IUiListener arg2) 3.2 参数说明 Bundle 参数 是否必传 类型 参数说明 Constants.PARAM_RECEIVER 必传 String 若receiver包含OpenID,则表示使用模式一(应用指定接收者模式);若receiver为空,代表使用模式二(用户指定接收者模式) 1) 传入的OpenID必须为应用内关系链,即为已安装该应用的QQ好友 2) 传入个数不得超过10个,若超过10个则自动截取前10个,剩余舍弃 授权使用应用内关系链的应用才可使用模式一(应用指定接收者) Constants.PARAM_TITLE 必传 String 免费礼物或请求名称(最多6个汉字) Constants.PARAM_SEND_MSG 必传 String 礼物或请求的默认赠言,由应用传入,当应用未传入时使用系统默认赠言 长度限制:35个汉字以内,超过限制自动截断 Constants.PARAM_IMG_URL 必传 String 请求或礼物配图的URL。如果不传,则默认在弹框中显示应用的icon "exclude" 可选 String 在用户自己指定好友的场景中,如果开发者不希望某些用户显示在好友选择器中,可传入这些用户的openid,多个openid之间用“,”分隔(“exclude”和“specified”一共最多可传入50个openid),好友选择器则不显示这些openid对应的用户。 "specified" 可选 String 在用户自己指定好友的场景中,如果开发者需要在好友选择器中显示指定的用户,可传入这些用户的openid,多个openid之间用“,”分隔(“exclude”和“specified”一共最多可传入50个openid
- com.tencent.tauth.Tencent.reAuth
1. 接口说明 当应用调用API返回没有权限(返回码为100030)时,可以调用增量授权函数让用户重新进行授权。调用时所使用的参数跟登录是一样的,只是在授权页面那里只会显示要增量授权的项,即所传的scope参数。 注意:这里的scope参数跟登录时所传的scope参数作用是不一样的,这里只需要传需要增量授权的项,即用户之前没有授权的项。一般来说,就是前面调用失败的那个API的scope。 2. 使用场景 当应用调用API返回没有权限(返回码为100030)时,可以调用增量授权函数让用户重新进行授权 3. 接口调用说明 3.1 接口方法 int com.tencent.tauth.Tencent.reAuth(Activity activity, String scope, IUiListener listener) 3.2 参数说明 参数 参数说明 activity scope 应用需要用户增量授权权限,由“,”分隔。例如: SCOPE = “get_user_info,add_topic” listener 3.3 示例代码 //调用"add_topic" API的listener IUiListener listener = new BaseUiListener() { @Override protected void doComplete(JSONObject response, Object state) { int ret = response.getInt("ret"); if (ret == 100030) { // 这里进行增量授权的操作 if (mNeedReAuth) { Runnable r = new Runnable() { public void run() { mTencent.reAuth(MainActivity.this, "add_topic", new BaseUiListener()); } }; MainActivity.this.runOnUiThread(r); } } } }; 3.4 返回码说明 0: 正确 其它: 失败 OpenAPI公共错误码说明详见:Android常见问题及公
- com.tencent.tauth.Tencent.setAvatar
特别声明:出于信息安全的考虑,本接口仅对可信赖的合作应用开放。已经成功接入“QQ登录”的应用需提交申请以获取访问本接口的权限。 1. 接口说明 接口的基本流程: (1)判断用户是否存在登录态并且是否获取了openid; (2)创建一个Bundle,并填入必要参数; (3)调用SDK中Tencent类的setAvatar方法,启动设置头像界面。 2. 使用场景 用户需要更改用户的QQ头像 3. 接口调用说明 3.1 接口方法 void com.tencent.tauth.Tencent.setAvatar(Activity activity, Bundle params) void com.tencent.tauth.Tencent.setAvatar(Activity activity, Bundle params, IUiListener listener) void com.tencent.tauth.Tencent.setAvatar(Activity activity, Bundle params, IUiListener listener, int enterAnim, int exitAnim) 3.2 注意事项 1. V1.6版本支持传入IUiListener,用于获得设置头像成功或者出错的通知。如果传入了IUiListener,则无需在Params中传入ReturnActivity,跳转逻辑在IUiListener#onComplete的实现中完成; 2. setAvatar(Activity activity, Bundle params) 已经不推荐使用,请更换为支持IUiListener的版本; 3. V1.6版还提供了切换动画的支持(enterAnim和exitAnim),其值为动画的资源文件(XML),可以查看Demo文件夹中的 /res/anim/zoomin.xml和zoomout.xml获得详细示例。 另外,设置QQ头像使用Tencent类中的setAvatar接口,setAvatar使用了一个Activity来让用户调整图片,因此要在项目的AndroidManifest.xml中增加一个Activity配置,如下: <application> <activity android:name="com
- com.tencent.tauth.Tencent.story
1. 接口说明 应用分享的基本流程为: (1)判断用户是否已经登录,且应用是否获取了openid; (2)创建一个Bundle,并填入必要参数; (3)调用SDK中Tencent类的story接口,启动分享界面。 通过调用Tencent类的story函数实现分享功能。 2. 使用场景 3. 接口调用说明 3.1 接口方法 int com.tencent.tauth.Tencent.story(Activity arg0, Bundle arg1, IUiListener arg2) 3.2 参数说明: 参数 是否必传 类型 参数说明 Constants.PARAM_TITLE 必传 String 分享的标题。 Constants.PARAM_IMAGE 必传 String 分享的图片URL。 Constants.PARAM_COMMENT 可选 String 用户分享时的评论内容,可由用户输入。 Constants.PARAM_SUMMARY 可选 String 分享的故事摘要。 Constants.PARAM_SOURCE 可选 String 由开发者自定义该参数内容,用于判断好友来源。 应用分享成功后,被邀请方通过邀请链接进入应用时会携带该参数并透传给应用。 Constants.PARAM_ACT 可选 String 分享feeds中显示的操作区文字,参数值可为: '进入应用', '领取奖励', '获取能量', '帮助TA'。 Constants.PARAM_PLAY_URL 可选 String 分享内容中携带的视频链接。 3.3 示例代码 private void onClickStory() { if (mTencent.isSessionValid() && mTencent.getOpenId() != null) { Bundle params = new Bundle(); params.putString(Constants.PARAM_TITLE, "AndroidSdk_1_3:UiStory title"); params.putString(Constants.PARAM_COMMENT, "AndroidSdk_1_3: UiStory
- com.tencent.tauth.Tencent.invite
特别声明:出于信息安全的考虑,本接口仅对可信赖的合作应用开放。已经成功接入“QQ登录”的应用需提交申请以获取访问本接口的权限。 1. 接口说明 邀请好友的基本流程为: (1)判断用户是否已经登录,且应用是否获取了openid; (2)创建一个Bundle,并填入必要参数; (3)调用SDK中Tencent类的invite接口,启动邀请界面。 通过调用Tencent类的invite函数实现邀请功能。 2. 使用场景 邀请好友使用该应用 3. 接口调用说明 3.1 接口方法 int com.tencent.tauth.Tencent.invite(Activity arg0, Bundle arg1, IUiListener arg2) 3.2 参数说明 参数 是否必传 类型 参数说明 Constants.PARAM_APP_ICON 必传 String 邀请弹框中显示的应用图标的URL。 Constants.PARAM_APP_DESC 必传 String 邀请弹框中显示的邀请内容。 Constants.PARAM_SOURCE 可选 String 由开发者自定义该参数内容,用于判断好友来源。 邀请成功后,被邀请方通过邀请链接进入应用时会携带该参数并透传给应用。 Constants.PARAM_ACT 可选 String 邀请feeds中显示的操作区文字,参数值可为: '进入应用', '领取奖励', '获取能量', '帮助TA'。如果不传该参数,则默认为'进入应用'。 3.3 示例代码 private void invite() { if (mTencent.isSessionValid() && mTencent.getOpenId() != null) { Bundle params = new Bundle(); params.putString(Constants.PARAM_APP_ICON, "http://imgcache.qq.com/qzone/space_item/pre/0/66768.gif"); params.putString(Constants.PARAM_APP_DESC, "AndroidSdk_1_3: inv
- Android_SDK常见问题
1. 返回码说明 使用SDK时,所有结果都会通过回调返回给应用。在回调的结果中,会包含每次调用结果的返回码。正常情况下返回码为0,表示调用成功。如果返回码不为0,说明调用出错,需要根据返回码的值来定位错误原因。 常用返回码与错误信息的对照,如下表所示: 返回码< 含义说明 -30001 由于网络质量抖动引起,如果持续时间较长,或发生概率比较高,请直接联系技术支持(联系方式: toddzhao@tencent.com)。 100030 用户未对应用进行授权,需要引导用户重新登录授权,并且在登录的Scope参数里,加上相应的API名称(请参考API列表)。 所有的API都必需经过QQ互联对应用授权),用户对应用授权后才可以调用。 100014 access_token过期,目前支持的access_token有效期为三个月,需要重新走登录流程,获取新的access_token。 后期也可以使用Refresh Token来获取新的access_token(该功能即将上线) 100015 access_token失效。要重新走登录流程,获取新的access_token。 产生该错误有两个原因: 1. 用户在QQ空间里取消了对应用的授权,会导致当前保存到应用里的AccessToken被废除掉。 2. 用户在不同的设备上进行了QQ登录,导致在原来设备上的保存的AccessToken被废除掉。 100016 access_token校验失败。建议先重新走登录流程来换取新的access_token,使用新的access_token仍然无法通过校验,请通过企业QQ联系技术支持(号码:800030681。直接在QQ的“查找联系人”中输入号码即可开始对话)。 更多返回码与错误信息的对照说明,请参考《公共返回码说明》文档。 2. 混淆说明 如果应用需要混淆代码,为了保证SDK的正常使用,建议不要混淆SDK的jar包,如果仍要混淆,需要在混淆规则中加上下面几行配置: -keep class * extends android.app.Dialog 编译时请选择Android SDK API Level 17或以上的版本,否则可能会导致混淆失败,出现下面的错误: 3. 授权相关 应用调用OpenAPI时,需要哪些授权? 应用调用Ope
- com.tencent.tauth.Tencent.logout
1. 接口说明 注销登录 2. 使用场景 用户希望登录的QQ账号退出应用 3. 接口调用说明 3.1 接口方法 void com.tencent.tauth.Tencent.logout(Context context) 3.2 参数说明 参数 参数说明 context 调用者的Context上下文,每一个Activity都有对应的Context。示例中的this为调用者Activity对应的Context。 3.3 示例代码 mTencent.logout(this); 3.4 返回码说明 0: 正确 其它: 失败 OpenAPI公共错误码说明详见:Android常见问题及公共返回码说明。
- com.tencent.tauth.Tencent.login
1. 接口说明 1. 如果开发者没有调用mTencent实例的setOpenId、setAccessToken接口,则该接口执行正常的登录操作; 2. 如果开发者先调用mTencent实例的setOpenId、setAccessToken接口,则该接口执行校验登录态的操作。如果登录态有效,则返回成功给app,如果登录态失效,则会自动进入登录流程,将最新的登录态数据返回给app。 建议应用每次启动时调用一次该接口(先调用setOpenId、setAccessToken),以确保每次打开应用时用户都是有登录态的。 2. 使用场景 用户使用QQ账号登录应用 3. 接口调用说明 3.1 接口方法 int com.tencent.tauth.Tencent.login(Activity activity, String scope, IUiListener listener) 3.2 参数说明 参数 参数说明 activity 调用者activity。应用使用SDK时,会从应用自己的Activity跳转到SDK的Activity,应用调用SDK的Activity即为这里的调用者activity。 scope 应用需要获得哪些接口的权限,由“,”分隔,例如:SCOPE = “get_user_info,add_topic”;如果需要所有权限则使用"all"。 listener 回调接口,IUiListener实例。 3.3 示例代码 public void login() { Tencent mTencent = Tencent.createInstance(AppID, this); if (!mTencent.isSessionValid()) { mTencent.login(this, Scope, new IUiListener() { @Override public void onError(UiError arg0) { // TODO Auto-generated method stub fail(arg0); } @Override public void onComplete(JSONObject arg0) { // TODO Auto-genera
- 运行示例代码_Android_SDK
1. 下载SDK及示例代码 下载Android SDK 及示例代码。在压缩包中,sample是存放示例代码的文件夹。 2. 导入示例代码 以下以eclipse为开发的IDE进行范例说明: 打开Eclipse,将示例代码导入。如下所示: 当您见到如下工程时(工程名可能不一致),就证明导入成功了。 3. 修改编译环境的默认编码方式 该工程默认使用UTF-8编码格式,如果您的工作区默认使用的编码格式非UTf-8,工程则可能会出现乱码及错误。 请右键工程,选择Properties,将Text File Encoding 修改为UTF-8。 4.运行示例代码 如下图所示:运行示例代码,手机则出现如下界面:如果没有输入APP_ID, 则默认使用Sdk的测试ID
- ios_sandbox1
1. SSO安全登录QQ帐号 iOS SDK支持应用跳转到手机QQ进行登录,给用户提供更加安全、快捷的体验 。如果用户没有安装手机QQ,将打开登录页面。 2. 分享到QQ和QQ空间 2.1 分享到QQ好友 分享到QQ好友支持发送: - 纯文本消息(QQApiTextObject) - 纯图片消息(QQApiImageObject) - 新闻类消息(QQApiNewsObject) - 音频类消息(QQApiImageObject) - 视频类消息(QQApiVideoObject) 在用户安装了手机QQ时通过手机QQ进行分享,否则调用浏览器页面进行分享。 其中文本消息,图文消息和音频消息的title是必须的,summary可以不填,具体调用请参考2.3 分享示例代码。 使用分享到QQ好友功能需要设置QQ业务回调,请参考6. 处理QQ业务的回调。 2.2 分享到QQ空间 分享到QQ空间的接口用于取代老的分享接口addShareWithParams(该接口已经废弃)。 分享到QQ空间支持发送: - 带有URL的消息 - 新闻类消息(QQApiNewsObject) - 音频类消息(QQApiImageObject) - 视频类消息(QQApiVideoObject) 分享时调用浏览器页面进行分享。其中title是必须的,summary可以不填,具体调用请参考2.3 分享示例代码。 使用分享到QQ空间功能需要设置QQ业务回调,请参考6. 处理QQ业务的回调。 2.3 分享示例代码 下面是各种分享消息的实例代码,作为开发者调用QQ好友分享和QQ空间分享的参考: 纯文本分享: QQApiTextObject *txtObj = [QQApiTextObject objectWithText:@"QQ互联测试"]; SendMessageToQQReq *req = [SendMessageToQQReq reqWithContent:txtObj]; //将内容分享到qq QQApiSendResultCode sent = [QQApiInterface sendReq:req]; 纯图片分享: NSString *imgPath = [[[NSBundle mainBundle] resourcePath] stringByAppendingP
- add_topic、add_weibo、add_feeds停止调用的通知
1、发表一条空间说说 add_topic 2、用户操作将同步到QQ空间动态 add_feeds 3、发表一条微博 add_weibo 由于产品整体调整和演化,该3种接口产生的消息已无太多的用户价值,为了开发者的利益,从2013年8月1日起以上该3个API停止使用,该3个API接口的功能仍然存在,并有新的优化,特转移或合并到其他API中使用: add_topic,请调用 add_share 获取发表QQ空间消息相关能力; add_feeds,请调用 add_share 获取发表QQ空间消息相关能力; add_weibo,请调用 add_t 获取发表腾讯微博消息相关能力; 请开发者核对自己的app或者网站代码和SDK,如调用了add_topic、add_weibo、add_feeds这3个接口,请修改接口代码,使用户体验正常,避免用户在使用贵网站或app出现异常。 对此造成的不便,QQ互联团队表示歉意,期望得到开发者的谅解,我们在不断努力为开发者创造更多的价值,感谢支持! 点击查看现所有API列表
- add_feeds
特别声明: 本接口已经关闭。
- add_topic
特别声明: 由于功能调整,此API关闭
- 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: a
- 签名档
- pc_sandbox1
注意事项 腾讯QQ互联平台为广大开发者整理了以下SDK列表,辅助开发者快速接入QQ登录、分享等功能。 使用时请注意: 1. 以下有 标志的是QQ登录团队提供的官方版本。 2. 欢迎广大开发爱好者自行开发其他语言版本的SDK,并分享到开发者论坛-开源SDK共享(惊喜礼物等你拿!) 3. 对于非官方SDK包,由于腾讯未对其进行验证,因此无法保证其可用性。使用时遇到问题请直接与作者联系或在论坛上反馈,腾讯公司将不提供相关的技术支持。 4. 本页面提供的SDK全部基于OAuth2.0协议,不再支持OAuth1.0。 SDK for 网站接入 SDK类型 最近更新日期 文件大小 说明 JS SDK 2012-05-30 方便网站快速接入QQ登录,QQ互联提供了JS-widget。 JS-widget是JS封装的SDK,只需要在网站引入JS文件,就可以用封装好的方法访问对应的API,开发简单。使用说明:详见 JS SDK使用说明。 修改历史: V1.0.1 解决了与浏览器已知的兼容性问题。 V1.0.0 适用于基于OAuth2.0的JavaScript网站接入。 PHP SDK v2.0 2013-01-07 91 K 使用说明:详见下载包中docQC SDK for php 2.0文档.doc中的说明。 修改历史:V2.0 更新了以下内容:1.重新架构、组织SDK; 2.封装url API调用,更易于开必者使用; 3.完善example示例接口。 MD5: 1A180F106EF785AE4A04E91EA1882A69 Java SDK v2.0 2013-01-07 3990K 使用说明:1.直接引入Sdk4J.jar 包至项目工程内。 2.修改qqconnectconfig.properties 文件,在指定修改的地方填写自己app的相关信息和要获取的scope权限(前4行信息)注意不要试图修改api的请求地址,这里之所以暴露出来是为了方便兼容以后的变动。 3.将qqconnectconfig.properties文件放到自己的项目的context ClassLoader的可以加载的目录下,一般放在项目的src目录即可。 4.查看demo程序,结合api doc文档,进行接口的调用。 MD5: F
- FAQ
- add_share(发表空间动态)及add_t(发表微博)API使用规范
- 请求临时token
- SDK下载_OAuth1.0
- Qzone_OAuth_1.0认证简介
- weiyun_upload_music
- weiyun_get_pic_thumb
- weiyun_delete_pic
- weiyun_get_pic_list
- weiyun_download_pic
- weiyun_upload_pic
- OpenAPI调用说明_OAuth1.0
- 【QQ登录】帐号登录
- 开发攻略_OAuth1.0
- 联调指引
- 开发指引
- OAuth2.0升级指引
- IOS_SDK使用说明
QQ互联移动接入iOS SDK 2.0.1 (2013 - 11 - 12) 1. 新增QQ空间分享组件 2. QQ好友分享支持分享音乐 3. QQ好友分享支持网络图片 4. 新增判断手机QQ版本接口 & 新增发起WPA临时会话接口 1. iOS开发视频教程 视频演示使用SDK进行QQ登录、分享消息到QQ、设置QQ头像等功能的开发过程 2. iOS SDK环境搭建 简单的教程让您快速熟悉SDK的使用 3. iOS SDK API使用说明 详细的文档让你轻松的调用SDK接口
- get_oauth2_token
- OAuth2.0开发文档
- get_tenpay_addr
- del_idol
- add_idol
- get_idollist
- get_fanslist
- get_other_info
- get_repost_list
- add_pic_t
- del_t
- add_t
- get_info
- check_page_fans
- list_photo
- add_album
- upload_pic
- list_album
- add_one_blog
特别声明: add_one_blog接口已于2014.3.31正式下线。请PC网站调用PC空间分享组件,移动端下载最新版本的SDK后调用shareToQQ或shareToQzone接口,以满足用户分享一条动态(feeds)到QQ空间的功能。 1 接口说明 登录用户发表一篇新日志。 1.1 URL OAuth2.0协议: https://graph.qq.com/blog/add_one_blog 1.2 格式 JSON,XML 1.3 HTTP请求方式 POST 1.4 输入参数说明 各个参数请进行URL 编码,编码时请遵守 RFC 1738 (1)通用参数 -OAuth2.0协议必须传入的通用参数,详见这里。 (2)私有参数 参数名称 是否必须 类型 描述 title 必须 string 日志标题(纯文本,最大长度128个字节,utf-8编码)。 content 必须 string 文章内容(html数据,最大长度100*1024个字节,utf-8编码). format string 定义API返回的数据格式。 取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。 注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。 1.5 请求示例 1. 请求参数以OAuth2.0协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值): access_token==********** oauth_consumer_key=123456 openid==********** format=xml title=test abc content=test content 2. 对参数进行URL编码后拼接出的POST请求包: POST /blog/add_one_blog HTTP/1.1 //…此处省去部分HTTP头部 Host: graph.qq.com Content-Length: 294 Connection: Keep-Alive Cache-Control: no-cache access_token=**********& oauth_consumer_key=123456& op
- add_share
特别声明: add_share接口已于2014.3.31正式下线。请PC网站调用PC空间分享组件,移动端下载最新版本的SDK后调用shareToQQ或shareToQzone接口,以满足用户分享一条动态(feeds)到QQ空间的功能。 1 接口说明 第三方网站可以调用本分享接口,在用户授权的情况下,可以以用户的名义发布一条动态(feeds)到QQ空间,此外还可在腾讯微博上发一条微博(用户可自己选择是否转发到微博)。 注意网站必须一次性将信息传输给本分享接口。 分享功能现在支持网页分享和视频分享。 本接口将替代add_feeds接口。新接入的网站请使用本接口,原有已经使用了add_feeds接口的网站需要进行代码改造,迁移到新的接口上来。 只有该场景下可以调用本分享接口: 用户主动分享。用户在网站上点击“分享”按钮,发布一条feeds到QQ空间中,分享某个视频,网页或者其它内容。 例如:某用户在某个第三方网站或应用上主动点击分享按钮,对某个信息发表了评论,网站或应用将以该用户的名义发表一条动态到QQ空间中,动态的具体展示如下: 上图中的1-5标注对feeds的组成以及规格进行了说明: 1. 用户评论:用户在第三方网站发布的评论等UGC信息,对应的参数为“comment”,选填项。 2. 分享的内容标题,含源网页URL,点击跳转至第三方网站网页,对应的参数为“title”和“url”,必填项。 3. 详细描述:网页摘要,对应的参数为“summary”,选填项。 如果分享到微博平台,则摘要内容不会在微博中显示,若希望在微博中展示分享的内容,建议将重要信息在评论中进行描述。 4. 外部图片:引用外部图片(大小不超过100 x 100 px),对应的参数为“images”,选填项。 5. 来源网站名称及域名:标明分享的来源,对应的参数为“site”和“fromurl”,必填项。 1.1 URL OAuth2.0协议:https://graph.qq.com/share/add_share 1.2 格式 JSON / XML 1.3 HTTP请求方式 POST 1.4 输入参数说明 各个参数请进行URL 编码,编码时请遵守 RFC 1738 (1)通用参数 -OAuth2.0协议必须传入的通用参数,详见这里。 (2)私有
- get_simple_userinfo
- get_user_info
What's New? 2013年5月,网站和移动应用都可以调用本接口。用户信息字段增加了QQ头像字段。 2012年9月20日,新增返回参数"is_yellow_year_vip",支持获取用户是否年费黄钻的信息。 1.接口说明 获取登录用户在QQ空间的信息,包括昵称、头像、性别及黄钻信息(包括黄钻等级、是否年费黄钻等)。 2.使用场景 此接口主要用于网站使用QQ登录时,直接拉取用户在QQ空间的昵称、头像、性别等信息,降低用户的注册成本。 3.接口调用说明 3.1请求说明 url https://graph.qq.com/user/get_user_info 支持验证方式 oauth2.0 格式 JSON http请求方式 GET 是否需要鉴权 需要 接口调试 点击这里测试 3.2输入参数说明 各个参数请进行URL 编码,编码时请遵守 RFC 1738。 (1)通用参数 -OAuth2.0协议必须传入的通用参数,详见这里 3.3请求示例 以OAuth2.0协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值): https://graph.qq.com/user/get_user_info? access_token=*************& oauth_consumer_key=12345& openid=**************** 3.4返回参数说明 参数说明 描述 ret 返回码 msg 如果ret<0,会有相应的错误信息提示,返回数据全部用UTF-8编码。 nickname 用户在QQ空间的昵称。 figureurl 大小为30×30像素的QQ空间头像URL。 figureurl_1 大小为50×50像素的QQ空间头像URL。 figureurl_2 大小为100×100像素的QQ空间头像URL。 figureurl_qq_1 大小为40×40像素的QQ头像URL。 figureurl_qq_2 大小为100×100像素的QQ头像URL。需要注意,不是所有的用户都拥有QQ的100x100的头像,但40x40像素则是一定会有。 gender 性别。 如果获取不到则默认返回"男" 3.5返回码说明 0: 正
- Android_SDK使用说明
- JS_SDK使用说明
特别说明: JS SDK 获取地址://connect.qq.com/qc_jssdk.js 为了让应用更快接入,腾讯提供了JS SDK。 JS SDK是现有最简单的接入QQ互联的方式。 JS SDK基于QQ互联OAuth2.0协议的client-side模式, 封装了登录流程与API列表中的所有OpenAPI调用方法。开发者不需了解协议,只需要前台交互,以及将相关的参数修改成自身对应的参数即可使用。 同时,QQ互联又提供了可供第三方高级需求进行自行配置的可选参数与相关函数,使开发者可以根据自身需求灵活使用。 本JS SDK不需要配置任何跨域文件,支持在绝大多数主流浏览器下使用;对于少数老版本的浏览器,需要浏览器支持flash插件来完成跨域通信的问题。 1. 实现QQ登录功能 开发者只需要按以下四个步骤粘贴代码到网页,即可实现QQ登录功能,过程非常简单快速。 Demo地址:https://github.com/felaozhiyong/qq_connenct_demo 1.1 引用JS SDK的JavaScript文件 1. 首先需要申请接入QQ登录,并成功获取到appid和appkey。 2. 在html页面适当的位置引入JS脚本包(将下面代码中的“APPID”替换为申请接入QQ登录时获得的appid;"REDIRECTURI"替换为申请接入QQ登录时输入的回调地址): <script type="text/javascript" charset="utf-8" src="http://connect.qq.com/qc_jssdk.js" data-appid="APPID" data-redirecturi="REDIRECTURI" ></script> 注意:回调地址必须以http或https开头。 1.2. 放置QQ登录按钮 在html页面需要插入QQ登录按钮的位置,粘贴如下代码: <span id="qqLoginBtn"></span> <script type="text/javascript"> QC.Login({ btnId:"qqLoginBtn" //插入按钮的节点
- 使用Implicit_Grant方式获取Access_Token
- 概念和术语
应用基本信息相关 1 AppID 字段类型:整型。 功能说明:申请QQ登录成功后,分配给应用的appid,用来标识唯一应用,不同应用的appid不可混用。 2 AppKey 字段类型:字符型。 功能说明:申请QQ登录成功后,分配给网站的appkey。appkey将在QQ登录过程中以及网站通过OpenAPI访问/修改空间受保护的资源时,用来计算签名值,以提高传输过程参数的防篡改性。 OAuth2.0协议相关 1 OAuth2.0协议 详见 :OAuth2.0简介。 2 access_token 访问OpenAPI时所必须的token。获取方式详见:获取access_token。 OAuth1.0协议相关 1 OAuth1.0协议 详见 :Qzone_OAuth_1.0认证简介。 2 oauth_consumer_key和oauth_consumer_secret oauth_consumer_key:申请QQ登录成功后,分配给网站的appid。 oauth_consumer_secret:对应申请QQ登录时分配的appkey。 3 oauth_signature 签名值,用来提高传输过程参数的防篡改性。签名值的生成详见 签名参数oauth_signature的说明。 4 oauth_timestamp unix时间戳(从UTC时间1970年1月1日00:00:00到当前时刻的秒数,不同语言中如何获取请google/baidu之)。 注意第三方服务器时间与腾讯服务器时间相差不能超过5分钟。 5 oauth_token及oauth_token_secret oauth_token:动态密码; oauth_token_secret:oauth_token对应的密钥。 在Qzone_OAuth整体处理流程的step1-step7中,我们可以看到每一步代表的含义是不同的: (1)step2和step3中,oauth token表示临时token; (2)step4和step5中,oauth token表示以授权的临时token; (3)step6和step7中,oauth token表示具有访问权限的access_token。 上述3种token中,只有access_token(及其secret)是长期有效的,和
- 其它问题
1. 用户是否可以解除网站使用QQ登录的绑定? 用户可在QQ空间中的个人设置选项“授权管理”中管理与第三方网站的连接。 建议第三方在自己的网站中设置同样的授权管理功能。 2. 没开空间的QQ号码登录的时候不能自动跳转到网站?有别的解决方案吗? 目前只能建议用户开通QQ空间。后续腾讯会优化这里的体验,非开通用户也能够正常使用QQ登录来登录网站。 3. 为什么用户用QQ帐号登录部分网站不能一键登录,还需要再输入用户名和邮箱? 这个与网站自身逻辑有关。一般来说用户第一次使用QQ帐号登录网站时,网站需要用户输入用户名和密码来实现QQ帐号和网站自身帐号的绑定。 如有其它问题,请联系企业QQ(800013811)。
- 开发接入相关问题
1. 返回码说明 详见:公共返回码说明。 2. 通过使用QQ登录第三方能获取QQ用户什么样的信息? 网站可以通过用户资料接口获取用户的空间昵称和头像,来丰富用户注册资料。 已登录用户可以将在网站上发布、分享的信息即时同步到QQ空间。 此外,还可以通过说说,相册,日志等开放接口使用户直接在网站上访问或修改他们在QQ空间上的数据,与QQ空间实现更以进一步的互联互通。 3. 通过使用QQ登录能否获取用户的QQ号码? 不能。用户登录成功后跳转回网站时,URL中传递的是openid而非QQ帐号,openid是经过转换的字符串。 此外,QQ帐号涉及用户隐私,接入QQ登录的网站应该遵守开发者协议不允许以任何理由获取或用户QQ帐号相关的信息。 4. 基于phpwind的网站能否使用QQ登录? QQ登录团队已提供全面支持Discuz!,PHPWind等平台的集成插件,即将支持CMS,shopEX等平台。请选择适合您网站的插件包下载安装。 详见: 集成插件。 5. 如何实现QQ登录?麻烦吗?需要很长的开发周期吗? 详见:网站接入流程。 6. 网站允许使用QQ登录后是否会暴露本网站的隐私数据? 网站可通过用户的授权向QQ空间推送用户的动态更新,以及其它优质内容或定向广告,腾讯方面不主动拉取第三方网站的任何数据内容。 7. 用户的登录信息存放在腾讯服务器还是本网站的服务器上? 为了保证用户QQ号码的安全,其登录信息放在腾讯服务器上。 8. 网站使用QQ登录时,需要实现哪些接口?腾讯提供了哪些OpenAPI? 需要实现两种接口: 1. OAuth登录相关接口,用来获取用户的access token和openid,详见OAuth2.0开发文档。 2. OpenAPI,用来访问和修改Qzone受保护的资源,详见API列表。 9. 为什么有的OpenAPI必须申请才能使用?如何申请?处理时间多长? 出于信息安全的考虑,部分OpenAPI仅对可信赖的合作网站开放。需要申请的接口,我们在API列表中进行了标注。 申请方式,处理时间及审核标准详见:OpenAPI权限申请。 10. access token有效期为多久? access token有效期为90天,每次调用api成功,自动续期90天。 11. 如果用户删除了对网站的授权(即access_tok
- 关于session的使用限制以及解决方案的说明
- 签名参数oauth_signature的说明
- OpenAPI权限申请
- 回调地址相关问题
1. 什么是回调地址? 用户点击QQ登录跳转到QQ登录页面,登录成功后,应该跳转回网站。回调地址即在这里用来指定跳转回网站的URL。回调地址注册的目的是为了保障第三方APPID帐户的安全,以免被其他恶意网站盗用。需注意:1. 需要填写到站点接收qq登录信息的接口 例如:http://网站首页域名/api/oauth/QQ/callback.php ;2. 具体跳转URL将在程序中指定路径以及请求参数进行构造。 2.什么样的回调地址才满足加强校验的条件? QQ互联登录返回给开发商的code,会传到开发商指定的专门处理code的URL,而不是域名下任意的URL,举个例子 1). 比如开发商处理QQ互联返回的Code的URL是 https://account.example.com/connect/callback/qq 2). 但是开发商在互联官网注册的回调地址是:example.com,因此属于不符合要求的回调地址。 3). 开发商需要到QQ互联官网上,把回调地址修改为把https://account.example.com/connect/callback/qq, 并去掉example.com。 4). 如果有多个回调地址的需求,可以多个回调,使用";"隔开,如"https://account.example.com/connect/callback/qq;https://account.example.com/connect/qc" 3. 回调地址错误的原因有哪些? 回调地址错误,会返回错误码:100010。 回调地址错误的原因如下: (1)没有传入域名; (2)传入的域名与申请接入时填写的回调地址域名冲突。 例如:申请时填写的回调地址是:http://example.com/qqlogin,传入的是http://example.com则会返回错误码,需保证填写的回调地址和请求的一致。 4. 如何修改回调地址? step1:点击 “应用管理” step2:找到需要修改回调地址的应用,点击“查看” step3: 在基本信息页面选择“修改” step4:修改回调地址,可填写多个根域名,以分号分隔,注意此处要包含“http://”部分。
- 申请相关问题
1. 如何申请? 在“管理中心”页面注册为开发者,创建网站/应用。 添加成功后,在管理中心的应用列表中即可看到该应用,以及对应的appkey和appid等信息。 2. 申请QQ登录需不需要审核?申请处理的时间一般为多长? 需要通过审核。创建应用后便可以立即获取QQ登录相关的appkey和appid。审核过程大约5个工作日,未审核通过的appid只能使用注册的QQ号码进行测试登录,审核通过的可以全量使用。 3. 未审核通过,会产生怎样的限制? 为了保障QQ用户登录第三方的安全性,避免违法站点/应用频繁调用QQ用户信息,并大量发送信息以致骚扰到其他好友群体,QQ互联平台对审核未通过的第三方应用采取"仅开发者帐号能登录"的限制。对此造成的不便,请您谅解。 4. 回调地址常见问题及修改方法 请参见回调地址常见问题及修改方法。 5. 申请QQ登录后,接下来怎么做? 根据开发攻略进行QQ登录相关的开发工作: 移动应用接入流程 | 网站接入流程。 6. 为什么我的网站收到了QQ登录功能被关停的邮件? 您的网站接入QQ登录之后,QQ登录团队会定期进行巡查,如果: 1. 不符合网站审核规范 2. 或者违反开发者协议, 我们会关停网站的QQ登录功能并告知网站。 7. 我的网站在海外,没有ICP运营许可证号,可以申请吗? 可以。 在“管理中心”页面正确填写网站资料并提交申请后,便可以立即获取QQ登录相关的appkey和appid,无需等待审核。 8. 申请QQ登录时提示“网站域名验证失败”? 验证失败可能由于以下原因导致: 1、验证代码未添加成功,请查看验证代码是否已成功添加到网站的HEAD标签中。 2、添加的验证代码与当前登录QQ号不匹配,不同QQ号进行验证时生成的验证码不同,请确认当前进行验证的QQ号生成的验证码与添加到网页源代码里的相同。 3、不允许使用跳转域名。 4、对于服务器或代理访问是否做了特殊处理,如:跳转到移动端页面。 如已正确添加验证码仍无法通过系统验证,请联系企业QQ:800013811进行咨询。返回码错误列表。 9. 我的网站应用需要迁移到另一个qq号码里。如何操作? 可到管理中心的控制台进行转移。 如原管理QQ号或密码已遗忘或丢失,请提供appid、密钥(appkey)、需要转移到的新QQ号、营业执照、网站备案复印件发到c
- 产品相关问题
1. 我的网站使用QQ登录会有什么样的好处? 海量新用户:用户使用已有的QQ号码即可登录网站,QQ一键登录更可减少登录交互操作,大大降低网站注册门槛,给网站带来海量新用户。 活跃的访问量:已登录用户可以将在网站上发布、分享的信息即时同步到QQ空间,使网站内容通过QQ好友关系链得到进一步的传播,从而提升网站的访问量。 丰富的开放API:网站可以通过用户资料接口获取用户的空间昵称和头像,来丰富用户注册资料。此外,还可以通过说说,相册,日志等开放接口使用户直接在网站上访问或修改他们在QQ空间上的数据,与QQ空间实现更以进一步的互联互通。 详见:网站接入概述。 2. 使用QQ登录是否收费? “QQ登录”和第三方网站共享QQ庞大的用户价值,同时为QQ用户提供更便捷服务和更优质内容,实现双向共赢,目前不收取任何费用。 3. 与其它网站的登录接入是否有冲突? QQ登录使用国际通用的的OAuth2.0协议进行验证与授权,第三方网站访问腾讯的用户信息时,使用的是腾讯公司为网站分配的access token,因此第三方网站与其它网站的登录接入并不受影响。 详见:OAuth2.0开发文档。 4. QQ登录和腾讯微博登录有什么不同? 相同点:均使用QQ帐号与密码登录。 区别: --QQ登录的主要优势是能将用户在第三方网站的动态通过好友互动的方式进行扩散,从而增加第三方网站的曝光率,对第三方网站的主要优势在网友社交方面。 --腾讯微博登录的主要优势是在信息转发方面。
- 数据统计说明
1. 数据统计功能说明 QQ互联为QQ登录组件、分享组件、赞组件和API接口提供了数据分析功能。 网站主将应用注册后,可以查看组件的数据分析报告,对组件的使用状况有更多的了解,并通过数据分析进行组件的调整和优化。 2. 开通流程 使用QQ互联数据统计功能前,网站主需要在connect.qq.com上添加并验证自己的站点。具体流程如下: 2.1 使用QQ帐号登录并访问管理中心 访问http://connect.qq.com ,使用QQ帐号登录后,进入管理中心页面,如下图所示: 2.2 注册为开发者 如果该QQ号码没有注册为开发者,则需要先注册为开发者。点击上图左侧的“注册为开发者”链接,出现如下表单: 2.3 添加网站/应用 注册成为开发者以后,点击“添加网站/应用”,填写所需资料并验证网站,然后点击“确定”提交: 2.4 在管理中心查看数据 添加成功后,访问“管理中心”,点击左侧菜单,即可查看各项功能(登录,分享,赞,API)的业务数据: FAQ 1.我添加并验证了站点,可以立刻看到数据统计吗,可以看到多久的数据? 对于已经添加并验证过的站点,如果您已经添加了社交组件,您可以查看到自数据统计系统上线后到目前为止的所有数据; 对于已经添加了组件尚未验证的站点,您可以在添加并验证站点后的第二天查看到数据,数据的起始时间就是您添加并验证站点通过的时间。 2.我可以查看到哪些数据? QQ互联数据统计支持对登录组件、分享组件、赞组件和API接口的数据分析功能。 3.我可以查看到当日的数据吗? 您可以在当日查看昨日的数据,我们会在以后不断优化,对实时性进行提升。 4.我可以查看某个页面的分享/赞的数据吗? 目前还不支持,我们会在下一个版本中实现此功能。 5.我可以知道每天的回流量吗? 可以,对于通过使用分享组件或赞组件将内容传播到QQ空间的站点,您可以查看到每日从QQ空间有多少回流访问量和用户。 6.我有其他建议,如何反馈给你们? 您可以访问QQ互联的产品交流论坛反馈给我们。
- 开发者协议
1. 重要须知 本协议是合作方(下称合作方或您)与腾讯公司及腾讯公司的合作单位(以下统称为腾讯或腾讯公司)之间关于您提交的相关网站与腾讯QQ空间连接并使用腾讯提供的各种服务(下称:QQ登录)的法律协议。 腾讯在此特别提醒,您欲使用QQ登录服务,必须事先认真审阅本服务条款,包括免除或者限制腾讯责任的免责条款及对您权利限制的条款。请您审阅并决定接受或不接受本服务条款(未成年人审阅时应得到法定监护人的陪同)。如您不同意本服务条款及/或腾讯随时对本服务条款的修改,您应不使用或主动取消腾讯公司提供的服务。否则,您的任何对QQ登录的相关服务的使用行为将被视为您对本服务条款的完全接受,包括接受腾讯对服务条款随时所做的任何修改。 本协议是基于QQ即时通讯软件的《软件许可及服务协议》、《腾讯网站服务条款》制定的,与其是不可分割的,同时,腾讯不时发布的关于QQ登录的各种规范、规则等也是本协议的一部分,您在使用本服务的同时即是对本协议、《软件许可及服务协议》、《腾讯网站服务条款》及各种规范、规则等所有条款的接受和遵守,以下简称服务条款或条款,这些服务条款可由腾讯随时更新,且毋须另行通知。服务条款一旦发生变更, 腾讯将在网页上公布修改内容。修改后的服务条款一旦在网页上公布即有效代替原来的服务条款。您可随时登录腾讯网站查阅最新版服务条款。 如果您选择提交QQ登录申请,即表示您同意接受本协议各项服务条款的约束。如果您不同意本服务条款,则不能获得使用本服务的权利。您若违反本服务条款规定,腾讯公司有权随时中止或终止您QQ登录服务的使用资格并保留追究相关法律责任的权利。 2. 术语 如无特别说明,下列术语在本协议中的含义为: 1.QQ登录:指由腾讯开放平台开发并开放运营的API接口,合作方通过该接口,将其自有网站与用户QQ账号绑定,绑定账号后,用户可通过用户绑定的QQ账号登录合作方的网站,并无需再注册的一种服务。通过这种服务将实现用户在合作方网站的信息、操作同步显示到用户的QQ空间,从而实现信息分享同步。 2.合作方:参与“QQ登录”合作的主体,包括但不限于公民、法人、其他组织。 3.平台用户:指所有使用QQ帐号在合作方网站登录的用户,以下简称平台用户或用户。 4.第三方:指腾讯公司、合作方以外的公民、法人、其他组织。 3. 合作方的权利和义务 1. 合作方在
- 网站前端页面规范
- 应用审核规范
本规范为第三方网站接入“QQ登录”的审核规范。 本规范旨在对申请QQ登录的合作方信息进行快速审核,建立审核机制,即对申请者各项步骤进行审核,并提供相关整改建议。 审核的目标为保护QQ用户的账号信息、个人信息和隐私的安全,保护用户虚拟财产(Q币、游戏道具等)和数据等方面的安全。 1. 网站内容规范 网站内容以及网站向QQ空间同步的内容必须满足: 1. 符合国家法律法规以及道德标准,传播内容健康向上,能给用户以正确的价值观引导; 2. 无色情、反动、暴力等违反中华人民共和国任何法律法规的内容; 3. 不准含有腾讯虚拟物品或衍生产品交易的内容、不准含有模仿腾讯中奖信息等钓鱼网站惯用的诈骗信息。 涉及腾讯相关产品的虚拟物品交易信息网站主要有:发布大量QQ号和游戏账号买卖、刷钻、刷Q币、盗号、出售以及制作本公司业务外挂、网站需按照腾讯提供的UI规范放置QQ登录按钮,制作本公司衍生产品(如QQ空间模版、日志模版等),以公司名义发布假中奖信息等。 2. 产品UI规范 网站需按腾讯提供的UI规范放置QQ登录按钮,不得擅自修改“QQ登录”图标,否则腾讯公司有权单方面中止QQ登录连接服务。 具体如下: 1. QQ登录按钮图标必须按照规范严格执行,不允许做任何修改; 2. QQ登录小图标+文字。小图标不允许做任何修改,文字可以稍作调整,但是文字中必须标有“QQ登录”、“QQ”、“登录”相关文字标示。 详见:网站前端页面规范 3. 接入申请流程 1. 在 http://connect.qq.com/manage/ 上提交网站的详细资料(网站名称,网站域名,网站回调地址),获取APP ID和APP KEY,进入QQ登录开发阶段。 2. 完成QQ登录开发(详细信息请参见网站接入流程),并在 http://connect.qq.com/manage/ 提交上线申请。 3. QQ互联审核团队进行QQ登录功能和网站审核(1-3个工作日); 4. 审核结果:(申请上线审核结果将以邮件方式发送至注册邮箱,同时申请者可在 http://connect.qq.com/manage/ 页面进行查询) (1)上线申请通过审核:在 http://connect.qq.com/manage/ 上可以查看到当前流程状态为“已上线”; (2)驳回申请:第三方网站根据驳回申请
- 微博私有返回码说明
- 公共返回码说明
公共返回码-for OAuth2.0协议 100000-100031:PC网站接入时的公共返回码 错误码 含义说明 0 成功。 100000 缺少参数response_type或response_type非法。 100001 缺少参数client_id。 100002 缺少参数client_secret。 100003 http head中缺少Authorization。 100004 缺少参数grant_type或grant_type非法。 100005 缺少参数code。 100006 缺少refresh token。 100007 缺少access token。 100008 该appid不存在。 100009 client_secret(即appkey)非法。 100010 回调地址不合法,常见原因请见:回调地址常见问题及修改方法 100011 APP不处于上线状态。 100012 HTTP请求非post方式。 100013 access token非法。 100014 access token过期。 token过期时间为3个月。如果存储的access token过期,请重新走登录流程,根据使用Authorization_Code获取Access_Token或使用Implicit_Grant方式获取Access_Token获取新的access token值。 100015 access token废除。 token被回收,或者被用户删除。请重新走登录流程,根据使用Authorization_Code获取Access_Token或使用Implicit_Grant方式获取Access_Token获取新的access token值。 100016 access token验证失败。 100017 获取appid失败。 100018 获取code值失败。 100019 用code换取access token值失败。 100020 code被重复使用。 100021 获取access token值失败。 100022 获取refresh token值失败。 100023 获取app具有的权限列表失败。 100024 获取某OpenID对某appid的权限列表失
- SDK下载
腾讯QQ互联平台为广大开发者整理了以下SDK列表,辅助开发者快速接入QQ登录、分享等功能。 使用时请注意: 1. 对于非官方SDK包,由于腾讯未对其进行验证,因此无法保证其可用性。使用时遇到问题请直接与作者联系或在论坛上反馈,腾讯公司将不提供相关的技术支持。 2. 本页面提供的SDK全部基于OAuth2.0协议,不再支持OAuth1.0。 SDK for 移动应用接入 SDK类型 最近更新日期 文件大小 说明 iOS_SDK_V3.3.3 2018-5-24 2.1M V3.3.3功能亮点介绍: 未安装手Q的场景下,支持扫码登录 修改遗留bug,增强稳定性 Android_SDK_V3.3.3 2018-5-25 246k V3.3.3功能亮点介绍: 未安装手Q的场景下,支持扫码登录 https请求支持SNI 关闭部分debug log 修改遗留bug,增强稳定性 SDK for 移动游戏接入 SDK类型 最近更新日期 文件大小 说明 Android_opensdk_game_V2.0.3 2018-8-1 61MB V2.0.3功能亮点介绍: 增加登录时上报渠道的接口,接口文档参考SDK内开发文档。 iOS_opensdk_game_V2.0.2 2018-1-12 153MB V2.0.2功能亮点介绍: 社交分享消息:通过游戏内分享,可以为游戏好友兼QQ好友赠送金币、钻石,并对许久未上线的好友做召回,一起继续在游戏内开黑。 会员特权:通过判定用户的QQ会员身份和等级,赠送不同的游戏礼包,促进用户的活跃性。 TMG音视频能力:提供音视频组件,支持需要实时语音、视频能力的游戏,让用户在游戏中随时沟通。 关怀系统能力:根据游戏侧上报的用户操作流水,配置对应的条件的礼包,用户一旦满足某个条件,即可立刻领取相关礼包,增强了游戏趣味性。 SDK for 网站接入 SDK类型 最近更新日期 文件大小 说明 JS SDK 2012-05-30 / 方便网站快速接入QQ登录,QQ互联提供了JS-widget。 JS-widget是JS封装的SDK,只需要在网站引入JS文件,就可以用封装好的方法访问对应的API,开发简单。使用说明
- API列表
特别声明: add_share和add_one_blog接口已于2014.3.31正式下线。请PC网站调用PC空间分享组件,移动端下载最新版本的SDK后调用shareToQQ或shareToQzone接口,以满足用户分享一条动态(feeds)到QQ空间的功能。 分组名称 适用平台 API接口 功能说明 备注 访问用户资料 网站、移动 get_user_info 获取登录用户的昵称、头像、性别 访问用户QQ会员信息 网站、移动 get_vip_info 获取QQ会员的基本信息 需要申请 get_vip_rich_info 获取QQ会员的高级信息 访问我的空间相册 网站、移动 list_album 获取用户QQ空间相册列表 需要申请 upload_pic 上传一张照片到QQ空间相册 add_album 在用户的空间相册里,创建一个新的个人相册 list_photo 获取用户QQ空间相册中的照片列表
- 联系我们
- 移动应用接入流程
- 应用接入新手指引
- 移动应用接入概述
- 网站接入概述
1. 网站接入介绍 QQ互联开放平台为第三方网站提供了丰富的API。第三方网站接入QQ互联开放平台后,即可通过调用平台提供的API实现用户使用QQ帐号登录网站功能,且可以获取到腾讯QQ用户的相关信息。 第三方网站也可以调用腾讯方提供的API实现网站的分享、评论、邀请等功能,即网站的社交化功能。且可以将相关信息同步到QQ空间、腾讯朋友、腾讯微博等平台,建立网站与腾讯各平台的互动关系,利用庞大的QQ用户群来实现网站的快速传播。 网站接入QQ互联开放平台后,您将获得: 海量新用户:用户使用已有的QQ号码即可登录网站,QQ一键登录更可减少登录交互操作,大大降低网站注册门槛,给网站带来海量新用户。 活跃的访问量:已登录用户可以将在网站上发布、分享的信息即时同步到QQ空间,使网站内容通过QQ好友关系链得到进一步的传播,从而提升网站的访问量。 丰富的开放API:网站可以通过用户资料接口获取用户的空间昵称和头像,来丰富用户注册资料。此外,还可以通过说说,相册,日志等开放接口使用户直接在网站上访问或修改他们在QQ空间、腾讯朋友、腾讯微博上的数据,与腾讯各平台实现更进一步的互联互通。 2. 网站接入方式 第三方网站主要通过使用“QQ登录”接入QQ互联开放平台。 详细的接入指引请参见网站接入流程。 “QQ登录”是QQ互联开放平台提供给第三方网站的一种服务。 “QQ登录”可以让用户使用QQ帐号在第三方网站上登录,分享内容、同步信息,大大降低了用户注册的门槛。 同时,第三方网站根据用户提供的绑定信息,将用户在网站上发布的内容同步发布到QQ空间的个人动态中,从而借助QQ空间庞大的用户群,使网站的信息能通过好友关系得到进一步的传播,提升网站的访问量和用户数。 3. 使用QQ登录效果展示 下面描述了一个网站使用“QQ登录”,并访问和修改QQ用户个人信息的整个过程。 注意: 这里的描述意在简单的向网站开发者演示接入“QQ登录”需要进行哪些工作,以及效果如何。 3.1 网站上设置QQ登录入口 网站开发者可以在自己的网站首页入口和主要的登录、注册页面上放置“QQ登录”标识(见红色方框标记处): 3.2 用户选择用QQ帐号登录 用户点击按钮之后弹出QQ登录的窗口,在登录窗口中将显示网站自己的Logo标识,网站名称以及首页链接地址。 如下图所示: 如果用户已登录QQ软件,就不用
- QQ互联文档资料索引
重要更新 新手指引 Android接入开发 Oauth协议介绍 API文档 管理中心 常见问题 政策与规范 新手指引 一级目录 二级目录 三级目录 新手指引 网站接入概述 网站接入流程 移动应用接入概述 移动应用接入流程 联系我们 Oauth协议介绍 一级目录 二级目录 三级目录 Oauth协议介绍 OAuth2.0简介 OAuth2.0开发文档 准备工作 协作者帐号设置 放置“QQ登录”按钮 获取Access_Token 获取用户OpenID 调用说明 OAuth2.0升级指引 升级指引 说明指南 常见问题 API文档 一级目录 二级目录 三级目录 API文档 API列表 开发指引 开发攻略_Server-side 开发攻略_Client-side SDK下载 集成插件 返回码说明 公共返回码说明 微博私有返回码说明 管理中心 一级目录 二级目录 三级目录 管理中心 数据统计说明 常见问题 一级目录 二级目录 三级目录 常见问题 网站接入概述 申请接入流程 开发联调相关问题 其它问题 概念和术语 政策与规范 一级目录 二级目录 三级目录 政策与规范 网站审核规范 网站前端页面规范 开发者协议
- OAuth2.0常见问题
- 开发攻略_Client-side
- 开发攻略_Server-side
- OpenAPI调用说明_OAuth2.0
- 获取用户OpenID_OAuth2.0
本步骤的作用: 通过输入在上一步获取的Access Token,得到对应用户身份的OpenID。 OpenID是此网站上或应用中唯一对应用户身份的标识,网站或应用可将此ID进行存储,便于用户下次登录时辨识其身份,或将其与用户在网站上或应用中的原有账号进行绑定。 本步骤在整个流程中的位置: 上一步 server-side模式:请参见使用Authorization_Code获取Access_Token client-side模式:请参见使用Implicit_Grant方式获取Access_Token 1 请求地址 PC网站:https://graph.qq.com/oauth2.0/me 2 请求方法 GET 3 请求参数 请求参数请包含如下内容: 参数 是否必须 含义 access_token 必须 在Step1中获取到的access token。 4 返回说明 PC网站接入时,获取到用户OpenID,返回包如下: callback( {"client_id":"YOUR_APPID","openid":"YOUR_OPENID"} ); openid是此网站上唯一对应用户身份的标识,网站可将此ID进行存储便于用户下次登录时辨识其身份,或将其与用户在网站上的原有账号进行绑定。 5 错误码说明 接口调用有错误时,会返回code和msg字段,以url参数对的形式返回,value部分会进行url编码(UTF-8)。 PC网站接入时,错误码详细信息请参见:100000-100031:PC网站接入时的公共返回码。 下一步 OpenAPI调用说明_OAuth2.0
- 使用Authorization_Code获取Access_Token
本步骤的作用: 通过用户验证登录和授权,获取Access Token,为下一步获取用户的OpenID做准备; 同时,Access Token是应用在调用OpenAPI访问和修改用户数据时必须传入的参数。 移动端应用可以直接获得AccessToken,请参考使用Implicit_Grant方式获取Access_Token 本步骤在整个流程中的位置: 上一步 放置“QQ登录”按钮_OAuth2.0 1. 简介 即server-side模式,是OAuth2.0认证的一种模式,又称Web Server Flow; 适用于需要从web server访问的应用,例如Web网站。 其授权验证流程示意图如下(图片来源:OAuth2.0协议草案V21的4.1节 ) 对于应用而言,需要进行两步: 1. 获取Authorization Code; 2. 通过Authorization Code获取Access Token 2. 过程详解 Step1:获取Authorization Code 请求地址: PC网站:https://graph.qq.com/oauth2.0/authorize 请求方法: GET 请求参数: 请求参数请包含如下内容: 参数 是否必须 含义 response_type 必须 授权类型,此值固定为“code”。 client_id 必须 申请QQ登录成功后,分配给应用的appid。 redirect_uri 必须 成功授权后的回调地址,必须是注册appid时填写的主域名下的地址,建议设置为网站首页或网站的用户中心。注意需要将url进行URLEncode。 state 必须 client端的状态值。用于第三方应用防止CSRF攻击,成功授权后回调时会原样带回。请务必严格按照流程检查用户与state参数状态的绑定。 scope 可选 请求用户授权时向用户显示的可进行授权的列表。 可填写的值是API文档中列出的接口,以及一些动作型的授权(目前仅有:do_like),如果要填写多个接口名称,请用逗号隔开。 例如:scope=get_user_info,list_album,upload_pic,do_like 不传则默认请求对接口get_user_info进行授权。 建议控制授权项的数量,只传入必要
- 放置“QQ登录”按钮_OAuth2.0
本步骤的作用: 在网站页面上放置“QQ登录”按钮,并为按钮添加前台代码,实现点击按钮即弹出QQ登录对话框。 本步骤在整个流程中的位置: 上一步 准备工作_OAuth2.0 1. 下载“QQ登录”按钮图片,并将按钮放置在页面合适的位置 按钮图片下载: 点击这里下载 。 按照UI规范,将按钮放置在页面合适的位置:点击这里查看。 2. 为“QQ登录”按钮添加前台代码 2.1 效果演示 用户在页面上点击“QQ登录”按钮,将触发QQ登录对话框,效果如下图所示: 2.2 前台代码 为了实现上述效果,应该为“QQ登录”按钮图片添加如下前台代码: <img src=QQ登录图标文件在服务器上的地址 onclick=按钮点击事件> 2.3 代码示例 1. 写一个函数“toLogin()”,该函数通过调用“index.php”中的qq_login函数来实现将页面跳转到QQ登录页面。 (示例中的oauth/index.php,请参见从SDK下载页面下载PHP SDK,在Connect2.1文件夹下的index.php文件。 ) <script> function toLogin() { //以下为按钮点击事件的逻辑。注意这里要重新打开窗口 //否则后面跳转到QQ登录,授权页面时会直接缩小当前浏览器的窗口,而不是打开新窗口 var A=window.open("oauth/index.php","TencentLogin", "width=450,height=320,menubar=0,scrollbars=1, resizable=1,status=1,titlebar=0,toolbar=0,location=1"); } </script> 2. 为按钮添加“toLogin()”事件: <a href="#" onclick='toLogin()'> <img src="img/qq_login.png"></a> 下一步 server-side模式:请参见使用Authorization_Code获取Access_Token
- 协作者帐号设置
- 准备工作_OAuth2.0
本步骤的作用: 接入QQ登录前,网站需首先进行申请,获得对应的appid与appkey,以保证后续流程中可正确对网站与用户进行验证与授权。 本步骤在整个流程中的位置: 1. 申请appid和appkey 申请appid和appkey的用途 appid:应用的唯一标识。在OAuth2.0认证过程中,appid的值即为oauth_consumer_key的值。 appkey:appid对应的密钥,访问用户资源时用来验证应用的合法性。在OAuth2.0认证过程中,appkey的值即为oauth_consumer_secret的值。 申请地址 https://connect.qq.com/manage.html#/ 申请流程 1.开发者资质审核 参考文章:开发者注册流程 2. 申请appid(oauth_consumer_key/client_id)和appkey(auth_consumer_secret/client_secret); (1)进入https://connect.qq.com/manage.html#/页面,点击“创建应用”,在弹出的对话框中填写网站或应用的详细资料(名称,域名,回调地址); (2)点击“确定”按钮,提交资料后,获取appid和appkey。 注意:申请appid时,登录的QQ号码将与申请到的appid绑定,后续维护均需要使用该号码。 注意:对appid和appkey信息进行保密,不要随意泄漏。 2. 保证连接畅通 接入QQ登录时,网站需要不停的和Qzone进行交互,发送请求和接受响应。 1. 对于PC网站: 请在你的服务器上ping graph.qq.com ,保证连接畅通。 2.移动应用无需此步骤 下一步 放置“QQ登录”按钮_OAuth2.0
- OAuth2.0简介