基本信息
源码名称：QQ开发的部分接口API
源码大小：0.16M
文件格式：.rar
开发语言：C#
更新时间：2014-12-29
友情提示：（无需注册或充值，赞助后即可获取资源下载链接）
嘿，亲！知识可是无价之宝呢，但咱这精心整理的资料也耗费了不少心血呀。小小地破费一下，绝对物超所值哦！如有下载和支付问题，请联系我们QQ(微信同号)：78630559
本次赞助数额为： 2 元×
微信扫码支付：2 元
×
请留下您的邮箱，我们将在2小时内将文件发到您的邮箱
源码介绍
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);
}
}
}