腾讯客服-概念和术语

1 APP的基本信息
一个应用(APP)具有AppID,AppName,AppKey,中文别名,CanvasUrl等基本信息。

1.1 AppID字段类型:整型。

功能说明:应用的唯一标识,可以通过AppID查找APP基本信息。在调用OpenAPI的时候表明应用身份。AppID在创建应用时分配。

1.2 AppName字段类型:字符型。

功能说明:应用的唯一标识,可以通过AppName查找APP基本信息。在调用OpenAPI的时候表明应用身份。AppName在创建应用时分配。

1.3 AppKey字段类型:字符型。

功能说明:当应用通过OpenAPI调用腾讯社区开放平台资源时需要的加密串,用来验证应用的合法性。AppKey在创建应用时分配。

1.4 中文别名字段类型:字符型。

功能说明:应用在朋友社区/QQ空间中显示的中文名称,会在不同的地方有展现(例如在应用列表以及可安装应用列表中显示)。

如下图所示:某一个应用的中文别名为“巴别圣塔”。在应用列表以及可安装应用列表中,都以此名称显示。 

 

1.5 CanvasUrl字段类型:字符型。

功能说明:从朋友社区/QQ空间里面跳转到应用时用到的超链接,即应用的入口。

CanvasUrl可以是一个CGI Service的地址,也可以是一个HTML页面。

朋友社区前端应用跳转引擎会使用CanvasUrl来作为进入应用的总入口,然后根据应用的域名根目录,带上一些参数实现跳转。

例如:摩天大楼的CanvasUrl是:
http://main.skyscraper.qzoneapp.com/index.php

 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个字节:
0x00、0x00、0x00、0x00、0x00、0x00、0x00、0x00、0x00、0x00、0x00、0x00、0x00、0x1C、0x2D、0xF9。2.2 OpenKey字段类型:字符型。功能说明:是session key,访问OpenAPI时必需。
校验规则:长度为不固定的字符串,不能为空。
使用场景:将上文OpenID的说明。
如何获取:将上文OpenID的说明。

2.3 OpenAPI功能说明:

腾讯社区开放平台为第三方应用接入提供的编程接口。具体接口说明,参见API文档。对于已经上线的应用,还提供支付和监控系统接口。

 3 缩略语
SLA Service Level Agreement,ITSM中的服务级别协议,协议中定义了腾讯和第三方公司双方在对合作的SNS Game运营中,需要提供和承诺的服务要求。

QA 腾讯方的运营侧质量保证工程师,负责运营过程中相关的评审工作,质量度量和考核事宜。

ICS Internet Custom Service,指腾讯在线客户服务

IVR Interactive Voice Response, 交互式语音应答系统,指腾讯语音坐席客服。

CDN Content Delivery Network,即内容分发网络,使用户可以就近取得所需的内容,解决Internet网络拥挤的状况,提高用户访问网站的响应速度

http://kf.qq.com/faq/120322fu63YV130422FRVFfu.html

  1. da shang
    donate-alipay
               donate-weixin weixinpay

发表评论↓↓