腾迅平台接入笔记

腾迅平台接入笔记

 

CanvasURL

公共参数相关
1. 什么是OpenID, OpenKey？
OpenID：用户的唯一标识，根据APPID以及QQ号码生成，同样的QQ号在不同应用中OpenID也不一样。详见：概念和术语#OpenID。

OpenKey：用户的会话密钥（session key），同一个用户如果在不同时间打开多个应用页面，页面返回的OpenKey是不一样的，这些openkey在各自的页面都可用。详见：概念和术语#OpenID。

2. OpenID是否唯一？
OpenID根据APPID以及QQ号码生成，在每个应用中都是唯一，作为用户的唯一标识。

3. 是否能通过OpenAPI直接获取用户QQ号？
不能。用户在应用中的唯一标识是OpenID，腾讯开放平台不提供用户的QQ号。

4. 如何获取OpenID和Openkey等参数？
Step1: 了解什么是CanvasURL
CanvasURL也称之为应用开发地址。（你可能需要了解什么是CanvasURL。）
CanvasURL在2种场景下被引用：
-对于开发中的应用，从“开发者”应用中跳转到应用时，需要引用CanvasURL才能进入到应用。
-对于符合接入规范的应用，通过应用平台地址跳转到应用时，需要引用CanvasURL才能进入应用。

 

1.5 CanvasURL与应用平台地址

1. CanvasURL（即应用开发地址）：
（1）也称之为应用开发地址，CanvasURL不会展现在地址栏，只是用于跳转时引用（见下图标注）。
（2）CanvasURL由开发者填写（登录op.open.qq.com后进入管理中心，选择1个应用进入，在“应用管理”tab下的“平台信息”页面可看到应用开发地址填写框），它可以是一个CGI Service的地址，也可以是一个HTML页面。
（3）对于hosting应用来说，CanvasURL的域名是由平台分配的。
例如某个hosting应用其在空间平台的CanvasURL为如下，其中app10507.qzone.qzoneapp.com由平台分配：
http://app10507.qzone.qzoneapp.com?openid=xxxx&openkey=xxx&pf=qzone&pfkey=xxx... 
提交申请前，该地址可以任意填写；
准备提交申请时，需要改为实际调用地址，应用只需要在平台分配的域名后加上详细地址。对于多区多服应用，平台自动将分配的域名匹配至选区配置页，不允许修改。
（4）对于non-hosting应用来说，CanvasURL没有任何限制。 
（5）CanvasURL在2种场景下被引用：
-对于开发中的应用，从“开发者”应用中跳转到应用时，需要引用CanvasURL才能进入到应用（你可能需要了解如何进入“开发者”应用？）。
-对于符合要求的应用，通过应用平台地址跳转到应用时，需要引用CanvasURL才能进入应用。

注意：
（1）跳转到应用后，平台会在CanvasURL后带一些参数，应用可以通过解析CanvasURL来获取这些参数的值。
CanvasURL后一定会带的参数有：openid,openkey,pf,pfkey 
根据场景不同可能会带的参数有：invkey,iopenid,itime,source,app_custom 
invkey：邀请验证Key，为加密串，可参考v3/spread/verify_invkey中的说明；
iopenid：发起邀请者的openid；
itime：邀请时间；
source：由开发者自定义该参数内容，用于判断请求来源，可参考fusion2.dialog.sendRequest中的说明。
app_custom：由开发者自定义该参数，与source结合使用，可参考fusion2.dialog.sendRequest中的说明。

如果不知道如何解析CanvasURL以获取这些参数，点击这里；

腾讯开放平台联调工具集

http://open.qq.com/tools

 

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

 

腾讯罗盘是：
（1）腾讯提供的云计算服务之一；
（2）一款综合数据产品，中文名为“腾讯罗盘”，英文名为“compass”；
（3）为腾讯开放平台的应用开发者提供权威的数据分析服务；
（4）致力于海量数据的分析挖掘和可视化展现；
（5）提供平台分析和高级分析服务，开发者可根据自身需要选择合适的数据分析服务。 

 

应用图标

1. 图片简洁清晰，重点突出，界面层次清晰。

2. 图片不得描边、圆角。

3. 图片不得添加“new、hot、热、推荐”等标注。

4. 图片不得直接或间接使用腾讯公司或其它公司图案元素。

5. 图片中如需添加文字，文字应与应用名称和应用内容相符。

详见：前端页面规范#3. 应用图标以及预览图规格与规范。

 

新手引导

有新用户引导，能确保第一次进入应用的用户可以对产品功能、流程等进行大致了解。

 

 

7. 对不良信誉应用的处罚规则

当出现以下情况中的任意一种，开发者账号将被列入不良信誉名单，并进行相应的处罚。

 

不良信誉行为	处罚方式
服务器欠费，未缴清欠款，导致应用下线。	1. 添加至不良信誉名单中的开发者帐号，资质会被冻结，且不能修改； 2. 开发者在腾讯开放平台将无法创建新应用。
开发者名下出现3款及以上应用，被核实存在侵权（包括但不限于题材、图标等）及盗版。
每自然年，开发者名下的应用出现运营一级违规达到三次及以上。
提交虚假的开发者资质或应用资质信息。