腾讯社区开放平台C# SDK
腾讯社区开放平台是基于QQ空间、朋友社区(QQ校友)两大社交网络的开放平台。至今官方提供了一系列的开放接口(Open API)和开发工具包(SDK),开发者可以通过Open API获取登录用户信息、用户签名信息以及好友关系链信息等。已上线的应用还可以调用支付和监控接口,实现支付功能,查看应用实时运维数据。
腾讯官方给出了不少的SDK,点这里进入官方地址。遗憾的是没有开放C#的SDK。
我们DotNet开发者不能落后其它平台的开发者,这里开源我的腾讯社区开放平台SDK。
先上单元测试结果吧,这个还是比较重要的。
上面的七个方法对应腾讯官方文档的7个接口。
类库使用说明:
1、配置:你申请应用后,腾讯会给你AppId,AppKey,AppName这三个值,你需要把这三个值配置到App.config或者web.config中。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21 |
<? xml version = "1.0" encoding = "utf-8" ?> < configuration > < configSections > < section name = "qq.api" type = "System.Configuration.NameValueSectionHandler" /> </ configSections > < qq.api > < add key = "AppId" value = "APP ID" /> < add key = "AppKey" value = "APP KEY" /> < add key = "AppName" value = "APP NAME" /> </ qq.api > </ configuration > |
2、在你的项目中引用QQToolkit,然后使用如下方式调用
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17 |
User user = null ; try { user = QQClient.Instance.GetUserInfo( "openId" , "openKey" ); } catch (WebException ex) { throw ex; } |
QQClient.Instance是一个单例,你在调用接口的时候,需要传入腾讯给的openId和openKey才能正常的获取数据。QQ校友插件是通过iframe调用你的网站,而openId和openKey会通过url传参给你。可以通过Request.QueryString["openId"]和Request.QueryString["openKey"]得到。
openKey疑是时间戳,每次的值都不一样。你可以把腾讯给你的openId和openKey自己缓存起来方便使用,我测试过openKey的过期时间,7个小时内都能正常调用接口,但很奇怪的是每次测试都在7个小时左右的时间会停止。
组件内部的实现细节我就不再陈述,这里附上类图,具体的实现大家可以看源码。有问题可以给我留言(请移步至:http://blog.moozi.net/archives/qq-opensns-c-sharp-sdk.html)…