QQ分享和第三方登录申请教程

[V1.0.0]

[2017年3月]

【版权声明】

©️ 突唯阿 版权所有

本文档著作权归突唯阿所有，未经突唯阿实现书面许可，任何主体不可以任何形式复制、修改、抄袭、传播全部或部分本文档内容。

【商标声明】

及其他响站服务相关的商标均为上海突唯阿信息科技有限公司所有。本文档涉及的第三方主体的商标依法由权利人所有。

【服务声明】

本文档意在向客户介绍响站全部或者部分产品、服务的当时的整体概况，部分产品、服务的内容可能有所调整。您所购买的响站产品、服务的种类、服务的标准等应由您与突唯阿直接的商业合同约定，除非双方另有约定，否则，突唯阿对本文档内容不做任何明示或模式的承诺和保证。

目录

QQ分享和第三方登录申请教程

1. 腾讯开放平台应用引入图文引导（适用于APP）

1.1. 流程图

1.2. 如何注册开发者帐号

1.3. 选择注册开发者类型

1.4.  填写资料

1.4.1. 公司资质注册

1.4.2. 个人资质注册

1.5. 验证邮箱

1.6. 提交资质审核

1.7. 银行信息

1.8. 信息修改和资质变更

1.9. 证件号码已被注册？

1.10. 创建应用

1.11. 查看应用属性

1.12. 应用信息维护

1.12.1. 完善应用基本信息

1.12.2. 提交图标素材

1.12.3. 填写信任IP

1.12.4. 填写应用调试者信息

1.12.5. 填写客服信息

1.12.6. 填写平台信息

1.12.7. 签署协议

1.13. 提交应用上线申请

1.13.1. 应用申请上线的前提条件

1.13.2. 申请上线

1.14. 应用正式上线

2. QQ互联网站引入流程图文引导（适用于网页）

2.1. 流程图

2.2. 开发者注册

2.3. 网站接入申请

2.3.1. 添加网站

2.3.2. 网站信息完善

2.4. 网站开发

2.4.1. 开发流程概述

2.5. 开发说明

2.6. 使用QQ互联提供的OpenAPI

1.腾讯开放平台应用引入图文引导（适用于APP）

1.1.流程图

1.2.如何注册开发者帐号

请点击腾讯开放平台（http://open.qq.com/）页面右上角的“登录”按钮，使用QQ帐号登录（OPEN默认关联QQ帐号作为开发者标识帐号，请先注册好QQ帐号后，再点击登录并认证开发者资质）。

重要提示：开发者QQ号码一旦注册不能变更，建议使用公司公共QQ号码而不是员工私人号码注册，以免遇到员工离职等情况造成不必要的麻烦。

1.3.选择注册开发者类型

开发者帐号登录成功后会跳转到注册资质页面，在注册页面请选择注册开发者类型为公司或个人：

1.4. 填写资料

请确认开发者资质证明是否已符合接入规范，开发者资质证明清单如下：

1.4.1.公司资质注册页面如下，请按要求填写：

1.4.2.个人资质注册页面如下，请按要求填写：

1.5.验证邮箱

基本资料提交后，开发者需要进行邮箱验证。点击“立即验证”，进入注册邮箱点击链接确认，即可完成邮箱验证。

1.6.提交资质审核

邮箱验证成功后，如需创建应用，可点击“立即创建”，提交应用审核时，开发者资质会一并提交审核，请同时留意资质审核和应用审核结果。
如暂无需创建应用，只需注册开发者资质的，可在页面右上角点击登录的帐号，进入资质页面单独提交资质审核（点击编辑--保存--提交审核）。

1.7.银行信息

银行信息为选填，即需要接入我平台支付SDK的则需要填写完整的收款信息，如无需要则不用填写相关信息。

1.8.信息修改和资质变更

如需修改资质相关信息，包括更换不同个人或公司开发者名称，可在资质页面直接修改相关信息，重新提交资质审核通过后方可修改生效。

如需从个人开发者变更为公司开发者，或由公司开发者变更为个人开发者，可在资质页面选择更改类型，并修改不同资质类型下的相关信息，重新提交资质审核通过后方可变更生效。

1.9.证件号码已被注册？

注册开发者资质时，输入证件号码后，若出现如下提示，则说明该证件号码已绑定其他开发者帐号，个人开发者请先自行确定是否自己或曾授以他人在OPEN平台注册过资质，公司开发者请先内部确定是否其他同事OPEN平台注册过资质 。每个证件号码只能绑定一个开发者帐号，若需使用该证件号码重新注册开发者帐号，则必须将之前注册的账号注销。

1.10.创建应用

1. 如果您刚完成开发者注册，则注册验证成功后会跳转到以下页面。点击下图中的“创建应用”按钮，即可开始创建应用。

如果您之前已经创建过应用，则登录open.qq.com后点击页面右上角的“管理中心”，在管理中心首页即可看到创建应用的按钮。如下图所示：

2. 在如下的“创建应用”页面，填写应用的基本信息（如果对填写项不了解，请点击问号图标查看详细信息），并点击“创建”按钮。

其中在选择托管模式时，开发者需要选择是“腾讯托管”还是“非腾讯托管”。这里有一些规定和建议：
（1）为了保护用户数据，腾讯规定所有游戏类应用都必须选择腾讯托管模式。
（2）社交化工具类，社交化电子商务类等需要用到关系链的应用，建议选择腾讯托管模式。
（3）如果应用自有数据库里面已经存在有大量重要的数据，不想将这些数据迁移到腾讯的服务器上，为了数据互通，只能选择非腾讯托管模式。

1.11.查看应用属性

如下方式可以查看应用属性：
1. 应用创建成功后，会自动跳转到“应用总览”tab，在“应用总览”tab，可查看该应用被自动分配的AppID和APPKey等属性。
2. 登录op.open.qq.com后进入管理中心首页，在列表中选择1个应用进入，在“应用总览”tab，可查看该应用被自动分配的AppID和APPKey等属性。

AppID和APPKey由平台生成，不可更改。如下图所示：
 

下表解释了这些属性的含义： 

注意：

这里的APP ID 和 APP KEY 是用于进行第三方登录和分享的主体信息请牢记。

1.12.应用信息维护

应用信息完善后，才能将应用提交上线。

1.12.1.完善应用基本信息

登录open.qq.com后进入管理中心，选择1个应用进入，可看到“应用管理”tab。
点击即可进入应用管理页面进行应用信息的修改。如下图所示：
 

应用上线前，应用的基本信息都可以修改；
申请上线中，都不可以修改；
应用上线后，应用名称、应用分类和分区分服不可以修改，其他信息可以修改。修改后需要经过腾讯方同意才能生效。
应用信息列表如下：

1.12.2.提交图标素材

在“应用管理”tab的“图标素材”页面，添加应用图标。
每个图标的用途在素材提交页面的问号tips中有详细说明，您也可以查看图标素材及规范说明见：应用图标以及预览图规格与规范。

应用上线前，图标素材可以修改；
申请上线中，图标素材不可以修改；
应用上线后，图标素材可以修改，需要经过腾讯方同意才可生效。

请按要求添加相应的图标，如下图所示：

1.12.3.填写信任IP（仅针对非腾讯托管应用）

如果应用为非腾讯托管应用，则该应用不能调用腾讯开放平台提供的OpenAPI。只有填写了信任IP，才可以调用。
非腾讯托管应用的程序部署在开发者自己的服务器上，这些服务器的IP需要添加到信任IP中。当应用调用腾讯开放平台提供的OpenAPI时， 腾讯方会对开发者服务器IP进行验证，如果这些IP属于信任IP，则允许应用调用，否则应用没有权限调用。

应用上线前，信任IP可随意修改；
申请上线中，不可以修改；
应用上线后，信任IP可以修改，需要经过腾讯方同意才可生效。 

在“应用管理”tab的“信任IP”页面，填写服务器IP。每行只能填写一个IP，最多可以添加20个，如下图所示：
 

1.12.4.填写应用调试者信息

应用上线前需要进行调试，只有已添加的应用调试者，才可以在应用测试环境中预览和调试应用（详见：应用联调指引）。
开发者创建应用后，开发者的QQ号会自动添加到应用调试者列表中。其他的调试者QQ号，需要开发者手动添加到应用调试者列表中，且调试者必须为应用创建者的QQ好友。最多可以添加100个QQ号。
调试者信息可以随时修改。 

在“应用管理”tab的“应用调试者”页面，填写调试者的QQ号。如下图所示：
 

1.12.5.填写客服信息

依据平台内应用的外部链接使用规范，如应用内客服声明中需要使用客服用途的外部链接，需在流程中统一进行备案。腾讯方同意后通过fusion2.nav.open进行统一跳转。 

在“应用管理”tab的“客服信息”页面，填写客服用途的外部链接。如下图所示：

1.12.6.填写平台信息

在“应用管理”tab的“平台信息”页面，填写应用开发地址和应用高度，如下图所示：

平台信息详细说明如下：

1.12.7.签署协议

应用在上线前，必须签署开发者/用户协议，才能申请上线；必须签署收益补充协议，才能接入支付体系。
在管理中心的“应用管理”页签，选择“协议版权”，即可看到“开发者/用户协议”页面。

详细说明如下：

如下图所示：
1. 确认最终用户协议

2. 上传著作权文件（仅针对游戏类应用）

3. 签署收益补充协议

1.13.提交应用上线申请

1.13.1.应用申请上线的前提条件

1. 请确认应用是否符合腾讯应用接入规范中的关注项，如果不符合，请及时修改应用，否则应用将不能上线。
2. 参考腾讯产品上线前优化表，对应用进行优化。
3. 应用已测试联调通过，可以正常运行。提交申请后，核对中的应用不能进行测试联调。
4. 在管理中心的“应用管理”tab，所有页面的信息都已正确填写，并已签署相关的协议。

1.13.2.申请上线

在管理中心的“应用管理”tab中，所有页面的信息都已正确填写后，可在“应用总览”tab页看到平台下的信息完善度为100%。只有平台对应的信息完善度为100%，才可以在该平台申请上线。

1. 在管理中心的“应用总览”tab，点击要接入的平台下的“申请上线”按钮，如下图所示：


2. 点击“申请上线”按钮后，进入申请上线确认页面，如下图所示：

 
请再次确认：
应用的相关信息是否正确；
应用是否满足上线接入规范要点；
应用是否符合腾讯应用接入规范；
应用中OpenAPI的调用地址是否已由测试地址替换为正式地址；
是否已阅读腾讯开放平台应用运营管理办法。

3. 确认已做好上述所有的准备工作后，点击“确认申请”提交上线申请，此时应用的状态为“预上线”。

1.14.应用正式上线

如果应用不符合接入规范，腾讯方会通过管理中心的消息中心以及开发者注册的邮箱告知开发者不通过的原因，请开发者根据原因进行改造，确认满足要求后重新提交申请。
应用符合接入规范后，腾讯方也会通过管理中心的消息中心以及开发者注册的邮箱告知开发者。且在管理中心的“应用总览”tab，可以查看到申请上线“已通过”，如下图所示：
 

应用符合接入规范，完成上线准备后，由开发者确定上线时间。开发者点击“确认上线”后，应用成功上线，需要开发者为新版接入流程进行评分，评分后页面显示开发者获得的资源。点击“进入管理中心”后，开发者即可对应用进行管理。

此时，腾讯后台设置应用放量策略，并打开入口，应用将正式出现在应用中心“最新上线”模块。
应用正式上线后，可在平台的应用中心（Appstore）应用列表显示，腾讯用户登录该平台后可以在应用中心中找到自己喜欢的应用。
以QQ空间平台的应用中心为例：

2.QQ互联网站引入流程图文引导（适用于网页）

2.1.流程图

2.2.开发者注册

1. 在QQ互联开放平台首页 https://connect.qq.com/ ，点击右上角的“登录”按钮，使用QQ帐号登录，如下图所示：

重要提示：
开发者QQ号码一旦注册不能变更，建议使用公司公共QQ号码而不是员工私人号码注册，以免遇到员工离职等情况造成不必要的麻烦。

2. 登录成功后会跳转到开发者注册页面，在注册页面需要提交公司或个人的基本资料。下图所示的是公司注册页面：

2.3.网站接入申请

网站接入前，需首先进行申请，获得对应的appid与appkey，以保证后续流程中可正确对网站与用户进行验证与授权。

2.3.1.添加网站

开发者注册成功后，会跳转到“管理中心”页面。点击添加网站，填写相应的信息，如下图所示：

网站信息填写完成，点击“确定”后，网站注册完成，进入管理中心，在管理中心可以查看到网站获取的appid和appkey，如下图所示：

2.3.2.网站信息完善

在管理中心，点击申请的网站下的“编辑信息”，进入编辑页面，点击右上角的“编辑”按钮，页面进入编辑状态，即可对网站信息进行修改和完善，如下图所示：

2.4.网站开发

进入控制台页面，可以看到网站申请处于“开发”状态。网站上线，首先需对网站进行开发，即完成QQ登录功能并正常放置QQ登录按钮，如下图所示：

2.4.1.开发流程概述

开发流程主要包括如下几个步骤：

2.4.1.1.网站上设置QQ登录入口

网站主可以在自己的网站首页入口和主要的登录、注册页面上放置“QQ登录”标识（见红色方框标记处）：

网站需要下载官方提供的“QQ登录”按钮图片，并按照UI规范将按钮放置在页面合适的位置。

2.4.1.2.用户登录验证和授权

1. 用户点击QQ登录按钮之后，弹出QQ登录窗口，在登录窗口中将显示网站自己的Logo标识，网站名称以及首页链接地址。
如果用户已登录QQ软件，也可以一键快速登录。
如下图所示：

2. 成功登录后，弹出授权框引导用户授权（仅在第一次成功登录，以及第一次访问某个未授权的OpenAPI时会出现授权页），如下图所示：

授权框中的授权列表由网站自行配置。建议控制授权项的数量，只传入必要的接口名称，因为授权项越多，用户越可能拒绝进行任何授权。

2.4.1.3.登录和授权完成后，跳转回网站

如果用户成功登录并授权，则跳转到指定的回调地址，该回调地址由第三方网站自行配置（在上一步的请求中传入），回调地址建议设置为网站首页或网站的用户中心。

2.4.1.4.获取并存储access token以及openid

成功登录后，即可发送请求来获取access token以及openid，这两个参数在调用OpenAPI访问和修改用户数据时必须传入，网站需自行绑定或存储： （1）access token用来判断用户在本网站上的登录状态，具有3个月有效期，用户再次登录时自动刷新。 （2）openid是此网站上唯一对应用户身份的标识，网站可将此ID进行存储便于用户下次登录时辨识其身份，或将其与用户在网站上的原有帐号进行绑定。

3.1.5 在网站上显示用户登录昵称与QQ头像

建议网站调用get_user_info接口，在首页或顶部显示用户通过QQ帐号的登录状态，使用户体验一致，包括用户昵称、QQ头像，如下图所示：

2.5.开发说明

QQ登录功能使用国际通用的OAuth2.0协议进行验证与授权，可通过以下两种方式进行网站开发：
（1）使用QQ互联提供的SDK包，用户体验统一，只需要修改少量代码，不需要理解验证授权流程，需要快速接入QQ登录的应用可选用此方法。
（2）根据QQ登录OAuth2.0协议，自主开发，此方法自定义程度较高，需要与现有系统进行整合的网站可选用此方法。
（3）社区类网站可以使用集成插件快速接入QQ登录。

2.6.使用QQ互联提供的OpenAPI

完成网站的开发后，即可在“管理中心”的“控制台”页面，点击“当前流程”下的“申请上线”，流程处于“审核”状态。
提交审核后，腾讯会在两个工作日完成审核，审核通过后，网站即正式上线。
网站上线后，可以使用QQ互联提供的丰富的API资源：
1. 我们提供了各种OpenAPI给开发者，网站可以调用这些API来实现需要的功能，使登录用户在网站上即可访问和修改QQ空间受保护的资源。
2. 为方便网站快速使用这些API，QQ互联提供了JS-widget， JS-widget是JS封装的SDK，只需要在网站引入JS文件，就可以用封装好的方法访问对应的API，开发简单。