.NET调用腾讯云API实例

最近项目有用到腾讯云的身份识别接口，话不多说，直接上代码：

         private void IDCardVerification(HttpContext context)
         {

             string imgStr = context.Request["ImageBase64"];
             if (!string.IsNullOrEmpty(imgStr))
             {
                 try
                 {
                     //请求地址
                     string settingUrl = ConfigurationManager.AppSettings.Get("IDCardVerifUrl");
                     //应用ID
                     string secretId = ConfigurationManager.AppSettings.Get("TcCloudSecretId");
                     //应用key
                     string secretKey = ConfigurationManager.AppSettings.Get("TcCloudSecretKey");
                     //时间戳
                     string timesTamp = GetTimeStamp();
                     //Nonce
                     var nonce = new Random().Next(, );
                     //拼接参数
                     string paramsStr = string.Format(@"Action=IDCardOCR&CardSide=FRONT&ImageBase64={0}&Nonce={1}&Region=ap-guangzhou&SecretId={2}&SignatureMethod=HmacSHA1&Timestamp={3}&Version=2018-11-19",
                         imgStr, nonce, secretId, timesTamp);
                     //生成签名参数
                     string requestText = "POST" + settingUrl.Replace("https://", "") + "?" + paramsStr;
                     //获得请求签名
                     string signText = GetHmacSha1Sign(secretKey, requestText);
                     //这里一定要进行URL编码，不然调用API会报错
                     signText = HttpUtility.UrlEncode(signText, Encoding.UTF8);
                     imgStr = HttpUtility.UrlEncode(imgStr, Encoding.UTF8);
                     paramsStr = string.Format(@"Action=IDCardOCR&CardSide=FRONT&ImageBase64={0}&Nonce={1}&Region=ap-guangzhou&SecretId={2}&Signature={3}&SignatureMethod=HmacSHA1&Timestamp={4}&Version=2018-11-19",
                         imgStr, nonce, secretId, signText, timesTamp);
                     //请求腾讯API，返回身份证信息
                     string resultStr = Globals.SendRequest(settingUrl, paramsStr);
                     var idCard = new JavaScriptSerializer().Deserialize<IDCardVerif>(resultStr);
                     var iDCardInfo = idCard.Response;
                     if (iDCardInfo.Error != null)
                     {
                         context.Response.Write("{\"Status\":\"fail\",\"errorMsg\":\"身份证识别出错： " + iDCardInfo.Error.Message + " \"}");
                     }
                     else
                     {
                         var result = new { Status = "success", data = new { iDCardInfo.name, iDCardInfo.Sex, iDCardInfo.Nation, iDCardInfo.IdNum, iDCardInfo.Address, iDCardInfo.Birth } };
                         context.Response.Write(new JavaScriptSerializer().Serialize(result));
                     }
                 }
                 catch (Exception ex)
                 {
                     context.Response.Write("{\"Status\":\"fail\",\"errorMsg\":\"请求接口出错 \"}");
                 }
             }
             else
             {
                 context.Response.Write("{\"Status\":\"fail\",\"errorMsg\":\"请选择上传的图片！\"}");
             }

         }

         /// <summary>
         /// 获取时间戳
         /// </summary>
         /// <returns></returns>
         public static string GetTimeStamp()
         {
             TimeSpan ts = DateTime.UtcNow - new DateTime(, , , , , , );
             return Convert.ToInt64(ts.TotalSeconds).ToString();
         }

         /// <summary>
         /// HMAC-SHA1加密返回签名
         /// </summary>
         /// <param name="secret">密钥</param>
         /// <param name="strOrgData">源文</param>
         /// <returns></returns>
         public static string GetHmacSha1Sign(string secret, string strOrgData)
         {
             var hmacsha1 = new HMACSHA1(Encoding.UTF8.GetBytes(secret));
             var dataBuffer = Encoding.UTF8.GetBytes(strOrgData);
             var hashBytes = hmacsha1.ComputeHash(dataBuffer);
             return Convert.ToBase64String(hashBytes);
         }

        public static string SendRequest(string url, string completeUrl)
         {
             HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
             request.Method = "POST";
             request.ContentType = "application/x-www-form-urlencoded";
             request.ProtocolVersion = HttpVersion.Version10;
             request.Host = url.Replace("https://", "").Replace("/", "");
             byte[] data = Encoding.UTF8.GetBytes(completeUrl);
             request.ContentLength = data.Length;
             Stream newStream = request.GetRequestStream();
             newStream.Write(data, , data.Length);
             newStream.Close();
             HttpWebResponse response = null;
             string content;
             try
             {
                 response = (HttpWebResponse)request.GetResponse();
                 StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8);
                 content = reader.ReadToEnd();
             }
             catch (WebException e)
             {
                 response = (HttpWebResponse)e.Response;
                 using (Stream errData = response.GetResponseStream())
                 {
                     using (StreamReader reader = new StreamReader(errData))
                     {
                         content = reader.ReadToEnd();
                     }
                 }
             }
             return content;
         }

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace Hmeshop.Entities
{
    public class IDCardVerif
    {
        public IDCardVerifInfo Response { get; set; }

    }

    public class IDCardVerifInfo
    {
        /// <summary>
        /// 姓名
        /// </summary>
        public string name { get; set; }

        /// <summary>
        /// 性别
        /// </summary>
        public string Sex { get; set; }

        /// <summary>
        /// 民族
        /// </summary>
        public string Nation { get; set; }

        /// <summary>
        /// 生日
        /// </summary>
        public string Birth { get; set; }

        /// <summary>
        /// 地址
        /// </summary>
        public string Address { get; set; }

        /// <summary>
        /// 身份证号
        /// </summary>
        public string IdNum { get; set; }

        /// <summary>
        /// 发证机关
        /// </summary>
        public string Authority { get; set; }

        /// <summary>
        /// 证件有效期
        /// </summary>
        public string ValidDate { get; set; }

        /// <summary>
        /// 扩展信息
        /// </summary>
        public string AdvancedInfo { get; set; }

        /// <summary>
        /// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
        /// </summary>
        public string RequestId { get; set; }

        /// <summary>
        /// 错误信息，有则返回，没有则为空
        /// </summary>
        public ErrorInfo Error { get; set; }

    }

    public class ErrorInfo {

        public string Code { get; set; }

        public string Message { get; set; }

    }

}

开始的时候，使用了HTTP的POST这种请求方式进行调用，但后面发现这种请求方式有Bug，一旦用户上传的图片尺寸太大（跟图片大小没关系，主要是尺寸），请求腾讯的API就会返回下面这个错误（PS:因为我这边使用的是OCR身份证识别API，如果不涉及图片文件的话，可以使用我上面的调用方式）：

根据图上的错误信息可知，需要用到TC3-HMAC-SHA256这个签名算法，So，没办法，我们只能用腾讯的SDK来调用了，SDK直接在VS的Nuget里下载就好了，在GitHub下载源码进行编译引用也行

下面贴腾讯官方SDK调用代码：

        private void IDCardVerificationBySDK(HttpContext context)
         {
             string imgStr = context.Request["ImageBase64"];
             try
             {
                 if (!string.IsNullOrEmpty(imgStr))
                 {
                     string res = string.Empty;

                     Action<string> action = t =>
                     {
                         res = GetOCRMsg(imgStr);
                     };
                     IAsyncResult asyncResult = action.BeginInvoke("调用腾讯云身份证识别", null, null);
                     asyncResult.AsyncWaitHandle.WaitOne();
                     if (res.Contains("message"))
                     {
                         context.Response.Write("{\"Status\":\"fail\",\"errorMsg\":\"" + res.Split(new string[] { "message:" }, StringSplitOptions.None)[] + "\"}");
                     }
                     else
                     {
                         IDCardOCRResponse resp = JsonConvert.DeserializeObject<IDCardOCRResponse>(res);
                         var result = new { Status = "success", data = resp };
                         context.Response.Write(JsonConvert.SerializeObject(result));
                     }
                 }
                 else
                 {
                     context.Response.Write("{\"Status\":\"fail\",\"errorMsg\":\"请选择上传的图片！\"}");
                 }
             }
             catch(Exception ex)
             {
                 Globals.Debuglog("调用接口出错：" + ex.StackTrace, "Tentent_IDCardVerif.txt");
             }

         }

         private string GetOCRMsg(string imgStr)
         {
             try
             {
                 Credential cred = new Credential
                 {
                     SecretId = ConfigurationManager.AppSettings.Get("TcCloudSecretId"),
                     SecretKey = ConfigurationManager.AppSettings.Get("TcCloudSecretKey")
                 };

                 ClientProfile clientProfile = new ClientProfile
                 {
                     SignMethod = ClientProfile.SIGN_TC3SHA256
                 };
                 HttpProfile httpProfile = new HttpProfile();
                 httpProfile.Endpoint = ("ocr.tencentcloudapi.com");
                 httpProfile.ReqMethod = "POST";
                 httpProfile.Timeout = ; // 请求连接超时时间，单位为秒(默认60秒)
                 clientProfile.HttpProfile = httpProfile;
                 OcrClient client = new OcrClient(cred, "ap-guangzhou", clientProfile);
                 IDCardOCRRequest req = new IDCardOCRRequest();
                 string strParams = "{\"ImageBase64\":\""+ imgStr + "\",\"CardSide\":\"FRONT\",\"ImageUrl\":\"\",\"Config\":\"\"}";
                 Globals.Debuglog("strParams: " + strParams, "Tentent_IDCardVerif.txt");
                 req = JsonConvert.DeserializeObject<IDCardOCRRequest>(strParams);
                 IDCardOCRResponse resp = client.IDCardOCR(req).
                     ConfigureAwait(false).GetAwaiter().GetResult();
                 return AbstractModel.ToJsonString(resp);
             }
             catch (Exception e)
             {
                 Globals.Debuglog("请求接口出错：" + e.StackTrace, "Tentent_IDCardVerif.txt");
                 return e.Message.ToString();
             }
         }
 

这里要注意的是，一定要使用异步请求的方式进行调用！ 不然直接调用的话，执行到：

ConfigureAwait(false).GetAwaiter().GetResult();

这一步会没有任何响应，程序陷入假死状态，博主就是在这里踩了坑，尝试了多次才发现这个问题，真是坑爹啊- -！

好了，就先说到这里了，这是本人在博客园的处女blog，希望给各位有需要的人一点帮助哈~