1 APP的基本信息 |
一个应用(APP)具有AppID,AppName,AppKey,中文别名,CanvasUrl等基本信息。
功能说明:应用的唯一标识,可以通过AppID查找APP基本信息。在调用OpenAPI的时候表明应用身份。AppID在创建应用时分配。 功能说明:应用的唯一标识,可以通过AppName查找APP基本信息。在调用OpenAPI的时候表明应用身份。AppName在创建应用时分配。 功能说明:当应用通过OpenAPI调用腾讯社区开放平台资源时需要的加密串,用来验证应用的合法性。AppKey在创建应用时分配。 功能说明:应用在朋友社区/QQ空间中显示的中文名称,会在不同的地方有展现(例如在应用列表以及可安装应用列表中显示)。 如下图所示:某一个应用的中文别名为“巴别圣塔”。在应用列表以及可安装应用列表中,都以此名称显示。
1.5 CanvasUrl字段类型:字符型。 朋友社区前端应用跳转引擎会使用CanvasUrl来作为进入应用的总入口,然后根据应用的域名根目录,带上一些参数实现跳转。 例如:摩天大楼的CanvasUrl是: |
2 开放接口相关信息 |
2.1 OpenID字段类型:字符型。 功能说明:OpenID是与APP通信的用户key,它和QQ号码一一对应,访问OpenAPI时必需。 校验规则:长度为32的16进制字符串,字符在[0-9A-F]范围内。 开发者必须按照该规则对请求中传来的OpenID进行校验。(根据该规则生成的正则表达式:^([0-9A-F]{32})$) 使用场景:在调用OpenAPI的时候,需要传入OpenID参数,用来表示取哪个用户的数据。 如何获取:当登录用户从朋友社区(QQ校友)平台进入应用时,跳转URL中将带有OpenID及OpenKey两个参数。 开发者需要解析该URL,以获取OpenID和Openkey的值并保存起来,用于后续调用OpenAPI时使用。 注意:使用前需要对OpenID和OpenKey做校验,以预防XSS漏洞。例如:某用户从朋友社区进入某个应用的跳转URL中,带有该登录用户的OpenID以及OpenKey: http://main.myapp.pengyou.qq.com/index.php?openid=000000000000000000900000001C2DF9&openkey=3CCEE2DDD1234567FE9DCA05EED929F228929FDCA80FC33C 备注:OpenID存储时建议按照16Bytes不可见字符进行存储。例如某OpenID的32Bytes的可见字符为 000000000000000000000000001C2DF9,每位字符代表一个Byte,存储时将相邻两个字符表示为一个字节,于是得到16个字节: 腾讯社区开放平台为第三方应用接入提供的编程接口。具体接口说明,参见API文档。对于已经上线的应用,还提供支付和监控系统接口。 |