腾迅平台接入笔记
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款及以上应用,被核实存在侵权(包括但不限于题材、图标等)及盗版。 | |
每自然年,开发者名下的应用出现运营一级违规达到三次及以上。 | |
提交虚假的开发者资质或应用资质信息。 |