移动应用接入流程
开发者注册 > 移动应用申请 > 移动应用开发 > 调用OpenAPI
1. 开发者注册
1. 在QQ互联开放平台首页 http://connect.qq.com/ ,点击右上角的“登录”按钮,使用QQ账号登录,如下图所示:
开发者QQ号码一旦注册不能变更,建议使用公司公共QQ号码而不是员工私人号码注册,以免遇到员工离职等情况造成不必要的麻烦。
2. 登录成功后会跳转到开发者注册页面,在注册页面需要提交公司或个人的基本资料。下图所示的是公司注册页面:
2. 移动应用接入申请
移动应用接入前,需首先进行申请,获得对应的appid与appkey,以保证后续流程中可正确对移动应用与用户进行验证与授权。
如果您的PC应用已经接入腾讯开放平台,则不需要重新获得appid与appkey,只需使用接入腾讯开放平台时获得的appid,即可添加为移动应用。
2.1 添加移动应用
开发者注册成功后,会跳转到“管理中心”页面。点击“添加移动应用”,填写相应的信息,如下图所示:
移动应用信息填写完成,点击“确定”后,移动应用注册完成,进入管理中心,可以查看到移动应用获取的appid和appkey,如下图所示:
2.2 添加已有应用为移动应用
如果您的PC应用已经接入腾讯开放平台,则该应用对应的手机客户端添加为移动应用时,只需输入在接入腾讯开放平台时获得的appid。
到“管理中心”页面,点击“添加已有应用为移动应用”,填写相应的appid,点击后面的“确定”,则会显示该应用的appid和appname,如下图所示:
点击“创建”后,移动应用添加完成,进入管理中心,可以查看到该移动应用对应的信息,如下图所示:
2.3 移动应用信息完善
在管理中心,点击申请的移动应用下的“编辑信息”,进入编辑页面,点击右上角的“编辑”按钮,页面进入编辑状态,即可对移动应用信息进行修改和完善,如下图所示:
3. 移动应用开发
进入控制台页面,可以看到移动应用申请处于“开发”状态。移动应用上线,首先需对移动应用进行开发,即完成QQ登录功能并正常放置QQ登录按钮,如下图所示:
3.1 开发流程概述
开发流程主要包括如下几个步骤:
3.1.1 移动应用上设置QQ登录入口
移动应用开发者可以在自己的移动应用首页入口和主要的登录、注册页面上放置“QQ登录”标识:
3.1.2 用户登录验证和授权
用户点击按钮之后弹出登录QQ账号的窗口,第一次登录或第一次访问某个未授权的OpenAPI时,在登录窗口中同时需要用户授权,用户可以选择授权移动应用访问自己的相关信息:
如下图所示:
授权框中的授权列表由移动应用自行配置,详见scope参数说明。建议控制授权项的数量,只传入必要的接口名称,因为授权项越多,用户越可能拒绝进行任何授权。
具体实现详见:
开发攻略的Step2
3.1.3 登录和授权完成后,跳转回移动应用
如果用户成功登录并授权,则跳转到指定的回调地址,该回调地址由第三方移动应用自行配置(在上一步的请求中传入),回调地址建议设置为移动应用首页或移动应用的用户中心。
3.1.4 获取并存储access token以及openid
成功登录后,即可发送请求来获取access token以及openid,这两个参数在调用OpenAPI访问和修改用户数据时必须传入,移动应用需自行绑定或存储:
(1)access token用来判断用户在本移动应用上的登录状态,具有3个月有效期,用户再次登录时自动刷新。
(2)openid是此移动应用上唯一对应用户身份的标识,移动应用可将此ID进行存储便于用户下次登录时辨识其身份,或将其与用户在移动应用上的原有账号进行绑定。
3.1.5 在移动应用上显示用户登录昵称与QQ头像
建议移动应用调用get_simple_userinfo接口,在应用中显示用户的信息,包括用户昵称、QQ头像,如下图所示:
详见:get_simple_userinfo。
3.2 开发说明
QQ登录功能使用国际通用的OAuth2.0协议进行验证与授权,可通过以下方式进行移动应用开发:
(1)QQ互联分别提供了iOS和Android的SDK开发包。如果手机安装了QQ,则启动手机QQ进行SSO登录。如没有安装,则通过手机系统的浏览器进行登录。登录的流程已经集成在SDK里,建议开发者使用此方法。详见:SDK下载
(2)根据QQ登录OAuth2.0协议,自主开发,此方法自定义程度较高,需要与现有系统进行整合的移动应用可选用此方法。
详见:OAuth2.0开发文档
对于Android2.1以下版本,访问https时会遇到签名证书验证的问题,解决方案可参考这里。
4. 使用QQ互联提供的OpenAPI
完成移动应用的开发后,即可在“管理中心”的“控制台”页面,点击“当前流程”下的“申请上线”,流程处于“审核”状态。
提交审核后,腾讯会在两个工作日完成审核,审核通过后,移动应用即正式上线。
移动应用上线后,可以使用QQ互联提供的丰富的API资源:
我们提供了各种OpenAPI给开发者,移动应用可以调用这些API来实现需要的功能,使登录用户在移动应用上即可访问和修改QQ空间受保护的资源。
详见:API列表 OpenAPI调用说明