在好例子网,分享、交流、成长!
您当前所在位置:首页C# 开发实例C#语言基础 → QQ开发的部分接口API

QQ开发的部分接口API

C#语言基础

下载此实例
  • 开发语言:C#
  • 实例大小:0.16M
  • 下载次数:23
  • 浏览次数:1648
  • 发布时间:2014-12-29
  • 实例类别:C#语言基础
  • 发 布 人:jzhx1234
  • 文件格式:.rar
  • 所需积分:2
 相关标签: 接口 QQ API

实例介绍

【实例简介】
【实例截图】

【核心代码】

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
using System;
using System.Data;
using System.Configuration;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Linq;
//泛型
using System.Collections.Generic;
//正则
using System.Text.RegularExpressions;
//http请求类
using NS_SnsNetWork;
//签名生成类
using NS_SnsSigCheck;
//上报类
using NS_SnsStat;
//json类
using System.Web.Script.Serialization;
//xml
using System.Xml;
 
namespace NS_OpenApiV3
{
    /**
     * .NET SDK for  OpenAPI V3
     *
     * @version 3.0.0
     * @author open.qq.com
     * @copyright © 2012, Tencent Corporation. All rights reserved.
     * @ History:
     *               3.0.1 | coolinchen | 2013-02-28 12:01:05 | modify response code
     *               3.0.0 | coolinchen | 2013-01-11 11:11:11 | initialization
     */
      
    public class OpenApiV3
    {
         /*错误码定义*/
        const int OPENAPI_ERROR_REQUIRED_PARAMETER_EMPTY = 1801;// 参数为空
        const int OPENAPI_ERROR_REQUIRED_PARAMETER_INVALID = 1802;// 参数格式错误
        const int OPENAPI_ERROR_RESPONSE_DATA_INVALID = 1803;// 返回包格式错误
        const int OPENAPI_ERROR_HTPP = 1900;// http请求异常, 偏移量1900
 
        private int appid = 0;
        private string appkey = "";
        private string server_name = "";
        private string format = "json";
        private string stat_url = "apistat.tencentyun.com";
        private bool is_stat = true;
 
         /// <summary>
         /// 构造函数
         /// </summary>
         /// <param name="appid">应用的ID </param>
         /// <param name="appkey">应用的密钥</param>
        public OpenApiV3(int appid, string appkey)
        {
            this.appid = appid;
            this.appkey = appkey;
        }
        public void SetServerName(string server_name)
        {
            this.server_name = server_name;
        }
        public void SetFormat(string format)
        {
            this.format = format;
        }
         public void SetStatUrl(string stat_url)
        {
            this.stat_url = stat_url;
        }
         public void SetIsStat(bool is_stat)
        {
            this.is_stat = is_stat;
        }
 
         /// <summary>
         /// 执行API调用,返回结果数组
         /// </summary>
         /// <param name="script_name">调用的API方法,比如/v3/user/get_info, 参考 http://wiki.open.qq.com/wiki/API_V3.0%E6%96%87%E6%A1%A3 </param>
         /// <param name="param">调用API时带的参数</param>
         /// <param name="method">请求方法 post / get</param>
         /// <param name="protocol">协议类型 http / https </param>
         /// <returns>返回结果数组</returns>
         public RstArray Api(string script_name, Dictionary<string, string> param, string method, string protocol)
        {
            RstArray result_array = new RstArray();
            // 检查 openid 是否为空
             if (string.IsNullOrEmpty(param["openid"]))
            {
                result_array.Msg = "openid is empty";
                result_array.Ret = OPENAPI_ERROR_REQUIRED_PARAMETER_EMPTY;
                return result_array;
            }
            // 检查 openid 是否合法
            if (!IsOpenId(param["openid"]))
            {
                result_array.Msg = "openid is invalid";
                result_array.Ret = OPENAPI_ERROR_REQUIRED_PARAMETER_INVALID;
                return result_array;
            }
            // 无需传sig, 会自动生成
            if (param.ContainsKey("sig"))
            {
                param.Remove("sig");
            }
 
            // 添加一些参数
            param["appid"] = appid.ToString();
            param["format"] = format;
             
            // 生成签名
            string secret = appkey   "&";
            string sig =  SnsSigCheck.MakeSig(method, script_name, param, secret);
            param.Add("sig", sig);
             
            string url = protocol   "://"   server_name   script_name;
 
            // 增加cookie
            Dictionary<string, string> cookie = new Dictionary<string, string>();
 
            //记录接口调用开始时间
            long start_time = SnsStat.GetTime();
 
            //通过调用以下方法,可以打印出最终发送到openapi服务器的请求参数以及url,不打印可以注释
            PrintRequest(url,param,method);
             
            // 发起请求
            result_array = SnsNetWork.MakeRequest(url, param, cookie, method, protocol);
            if (result_array.Ret != 0)
            {
                result_array.Ret  = OPENAPI_ERROR_HTPP;
                return result_array;
            }
 
             
            //解析返回结果的返回码
            string stat_ret = "";
            try
            {
                if (this.format == "xml")
                {
                    XmlDocument xml = new XmlDocument();
                    xml.LoadXml(result_array.Msg);
                    stat_ret = xml.LastChild["ret"].InnerText.ToString();
                }
                else
                {
                    JavaScriptSerializer serializer = new JavaScriptSerializer();
                    RstArray json_obj = new RstArray();
                    json_obj = serializer.Deserialize<RstArray>(result_array.Msg);
                    stat_ret = json_obj.Ret.ToString();
                }
            }
            catch (Exception e)
            {
                result_array.Msg = e.Message;
                // 远程返回的不是 json或者xml 格式, 说明返回包有问题
                result_array.Ret  = OPENAPI_ERROR_RESPONSE_DATA_INVALID;
                return result_array;
            }
            // 统计上报
            if (is_stat)
            {
                Dictionary<string, string> stat_params = new Dictionary<string, string>();
                stat_params["appid"] = appid.ToString();
                stat_params["pf"] = param["pf"];
                stat_params["rc"] = stat_ret;
                stat_params["svr_name"] = server_name;
                stat_params["interface"] = script_name;
                stat_params["protocol"] = protocol;
                stat_params["method"] = method;
                SnsStat.StatReport(stat_url, start_time, stat_params);
            }
 
        //通过调用以下方法,可以打印出调用openapi请求的返回码以及错误信息,不打印可以注释
        PrintRespond(result_array);
 
        return result_array;
        }
 
 
 
 
         /// <summary>
         /// 执行API调用,返回结果数组,重载函数
         /// </summary>
         /// <param name="script_name">调用的API方法,比如/v3/user/get_info, 参考 http://wiki.open.qq.com/wiki/API_V3.0%E6%96%87%E6%A1%A3 </param>
         /// <param name="param">调用API时带的参数</param>
         /// <returns>返回结果数组</returns>
         public RstArray Api(string script_name, Dictionary<string, string> param)
        {
            return Api(script_name, param, "post", "http");
         }
 
 
         /// <summary>
         /// 执行上传文件API调用,返回结果数组
         /// </summary>
         /// <param name="script_name">调用的API方法,比如/v3/t/add_pic_t, 参考 http://wiki.open.qq.com/wiki/API_V3.0%E6%96%87%E6%A1%A3 </param>
         /// <param name="param">调用API时带的参数</param>
         /// <param name="filename">文件名,文件相应参数的参数名,例如/v3/t/add_pic_t中的 "pic" </param>
         /// <param name="filepath">文件的路径 </param>
         /// <param name="protocol">协议类型 http / https</param>
         /// <returns>返回结果数组</returns>
         public RstArray ApiWithFile(string script_name, Dictionary<string, string> param, string filename,string filepath ,string protocol)
         {
             RstArray result_array = new RstArray();
             // 检查 openid 是否为空
             if (string.IsNullOrEmpty(param["openid"]))
             {
                 result_array.Msg = "openid is empty";
                 result_array.Ret = OPENAPI_ERROR_REQUIRED_PARAMETER_EMPTY;
                 return result_array;
             }
             // 检查 openid 是否合法
             if (!IsOpenId(param["openid"]))
             {
                 result_array.Msg = "openid is invalid";
                 result_array.Ret = OPENAPI_ERROR_REQUIRED_PARAMETER_INVALID;
                 return result_array;
             }
             // 无需传sig, 会自动生成
             if (param.ContainsKey("sig"))
             {
                 param.Remove("sig");
             }
 
             // 添加一些参数
             param.Add("appid", appid.ToString());
             param.Add("format", format);
              
             // 生成签名
             string secret = appkey   "&";
             string sig = SnsSigCheck.MakeSig("POST", script_name, param, secret);
             param.Add("sig", sig);
              
             string url = protocol   "://"   server_name   script_name;
             Dictionary<string, string> cookie = new Dictionary<string, string>();
             //记录接口调用开始时间
             long start_time = SnsStat.GetTime();
 
             //通过调用以下方法,可以打印出最终发送到openapi服务器的请求参数以及url,不打印可以注释
             PrintRequest(url, param, "post");
 
             // 发起请求
             result_array = SnsNetWork.MutilpartPostFile(url, param, cookie, protocol, filename, filepath);
 
             if (result_array.Ret != 0)
             {
                 result_array.Ret  = OPENAPI_ERROR_HTPP;
                 return result_array;
             }
 
             //解析返回结果的返回码,仅用于统计上报
             string stat_ret = "";
             try
             {
                 if (this.format == "xml")
                 {
                     XmlDocument xml = new XmlDocument();
                     xml.LoadXml(result_array.Msg);
                     stat_ret = xml.LastChild["ret"].InnerText.ToString();
                 }
                 else
                 {
                     JavaScriptSerializer serializer = new JavaScriptSerializer();
                     RstArray json_obj = new RstArray();
                     json_obj = serializer.Deserialize<RstArray>(result_array.Msg);
                     stat_ret = json_obj.Ret.ToString();
                 }
             }
             catch (Exception e)
             {
                 result_array.Msg = e.Message;
                 // 远程返回的不是 json或者xml 格式, 说明返回包有问题
                 result_array.Ret  = OPENAPI_ERROR_RESPONSE_DATA_INVALID;
                 return result_array;
             }
             // 统计上报
             if (is_stat)
             {
                 Dictionary<string, string> stat_params = new Dictionary<string, string>();
                 stat_params["appid"] = appid.ToString();
                 stat_params["pf"] = param["pf"];
                 stat_params["rc"] = stat_ret;
                 stat_params["svr_name"] = server_name;
                 stat_params["interface"] = script_name;
                 stat_params["protocol"] = protocol;
                 stat_params["method"] = "post";
                 SnsStat.StatReport(stat_url, start_time, stat_params);
             }
 
             //通过调用以下方法,可以打印出调用openapi请求的返回码以及错误信息,不打印可以注释
             PrintRespond(result_array);
 
             return result_array;
         }
 
 
 
 
         /// <summary>
         /// 执行上传文件API调用,返回结果数组,重载函数
         /// </summary>
         /// <param name="script_name">调用的API方法,比如/v3/t/add_pic_t, 参考 http://wiki.open.qq.com/wiki/API_V3.0%E6%96%87%E6%A1%A3 </param>
         /// <param name="param">调用API时带的参数</param>
         /// <param name="filename">文件名,文件相应参数的参数名,例如/v3/t/add_pic_t中的 "pic" </param>
         /// <param name="filepath">文件的路径 </param>
         /// <returns>返回结果数组</returns>
         public RstArray ApiWithFile(string script_name, Dictionary<string, string> param,  string filename, string filepath)
         {
             return ApiWithFile(script_name,param,filename,filepath,"http");
         }
 
         /// <summary>
         ///  打印出请求串的内容,当API中的这个函数的注释放开将会被调用。
         /// </summary>
         /// <param name="url">请求串内容</param>
         /// <param name="param">请求串的参数表单</param>
         /// <param name="method">请求的方法 get/post</param>
         static private void PrintRequest(string url, Dictionary<string, string> param, string method)
         {
             string query_string = SnsNetWork.MakeQueryString(param);
            if(method.Equals("get", StringComparison.OrdinalIgnoreCase))
            {
                url = url   "?"   query_string;
            }
            HttpContext.Current.Response.Write("<br><br>============= request info ================<br>");
            HttpContext.Current.Response.Write("method :"   method   "<br>");
            HttpContext.Current.Response.Write("url    :"   url   "<br>");
            if(method.Equals("post", StringComparison.OrdinalIgnoreCase))
            {
                HttpContext.Current.Response.Write("query_string : "   query_string   "<br>");
            }
            HttpContext.Current.Response.Write("<br>params:<br>");
            foreach(string key in param.Keys)
            {
                HttpContext.Current.Response.Write(key   " = "   param[key]   "<br>");
            }
            HttpContext.Current.Response.Write("<br><br>");
         }
 
         /// <summary>
         ///  打印出返回结果的内容,当API中的这个函数的注释放开将会被调用。
         /// </summary>
         /// <param name="RstArray">待打印的array</param>
         static private void PrintRespond(RstArray result_array)
        {
            HttpContext.Current.Response.Write("<br>============= respond info ================<br>");
            HttpContext.Current.Response.Write("ret = "   result_array.Ret   "<br>msg = "   result_array.Msg "<br>");
        }
 
        /// <summary>
        ///  检查 openid 的格式
        /// </summary>
        /// <param name="openid">openid</param>
        /// <returns>返回验证结果</returns>
         static private bool IsOpenId(string openid)
        {
            return (0 < Regex.Match(openid, "/^[0-9a-fA-F]{32}$/", RegexOptions.IgnoreCase).Groups.Count);
        }
 
    }
}

标签: 接口 QQ API

实例下载地址

QQ开发的部分接口API

不能下载?内容有错? 点击这里报错 + 投诉 + 提问

好例子网口号:伸出你的我的手 — 分享

网友评论

发表评论

(您的评论需要经过审核才能显示)

查看所有0条评论>>

小贴士

感谢您为本站写下的评论,您的评论对其它用户来说具有重要的参考价值,所以请认真填写。

  • 类似“顶”、“沙发”之类没有营养的文字,对勤劳贡献的楼主来说是令人沮丧的反馈信息。
  • 相信您也不想看到一排文字/表情墙,所以请不要反馈意义不大的重复字符,也请尽量不要纯表情的回复。
  • 提问之前请再仔细看一遍楼主的说明,或许是您遗漏了。
  • 请勿到处挖坑绊人、招贴广告。既占空间让人厌烦,又没人会搭理,于人于己都无利。

关于好例子网

本站旨在为广大IT学习爱好者提供一个非营利性互相学习交流分享平台。本站所有资源都可以被免费获取学习研究。本站资源来自网友分享,对搜索内容的合法性不具有预见性、识别性、控制性,仅供学习研究,请务必在下载后24小时内给予删除,不得用于其他任何用途,否则后果自负。基于互联网的特殊性,平台无法对用户传输的作品、信息、内容的权属或合法性、安全性、合规性、真实性、科学性、完整权、有效性等进行实质审查;无论平台是否已进行审查,用户均应自行承担因其传输的作品、信息、内容而可能或已经产生的侵权或权属纠纷等法律责任。本站所有资源不代表本站的观点或立场,基于网友分享,根据中国法律《信息网络传播权保护条例》第二十二与二十三条之规定,若资源存在侵权或相关问题请联系本站客服人员,点此联系我们。关于更多版权及免责申明参见 版权及免责申明

;
报警