LOOPC软件工作室

首页 » 技术文章 » 代码编程 » C# 电信能力开放平台API
admin - 2009/12/7 16:11:00
本代码封装了对电信能力开放平台提供的发短信、语言呼叫接口的调用。把此代码加到自己的项目中就很容易实现短信验证码、短信提示、回拨卡业务等功能。

TelephoneAPI.cs：
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Text;
  4. using System.Security.Cryptography;
  5. using System.Web;
  6. using System.Net;

  8. namespace Telephone
  9. {
  10.     public enum ResultCode
  11.     {
  12.         OK = 200,
  13.         非法请求_禁止发送 = 403,
  14.         请求消息错误 = 400,
  15.         请求失败 = 480
  16.     }


  19.     public class API
  20.     {
  21.         string transactionID;
  22.         string token;


  25.         #region 获取由SHA1加密的字符串
  26.         public string EncryptToSHA1(string str)
  27.         {
  28.             SHA1CryptoServiceProvider sha1 = new SHA1CryptoServiceProvider();
  29.             byte[] str1 = Encoding.UTF8.GetBytes(str);
  30.             byte[] str2 = sha1.ComputeHash(str1);
  31.             sha1.Clear();
  32.             (sha1 as IDisposable).Dispose();
  33.             return Convert.ToBase64String(str2);
  34.         }
  35.         #endregion

  37.         #region 获取由MD5加密的字符串
  38.         public string EncryptToMD5(string str)
  39.         {
  40.             MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider();
  41.             byte[] str1 = Encoding.UTF8.GetBytes(str);
  42.             byte[] str2 = md5.ComputeHash(str1, 0, str1.Length);
  43.             md5.Clear();
  44.             (md5 as IDisposable).Dispose();
  45.             return Convert.ToBase64String(str2);
  46.         }


  49.         #endregion

  51.         public string GetBase64String(string str)
  52.         {
  53.             byte[] buf = Encoding.UTF8.GetBytes(str);
  54.             return Convert.ToBase64String(buf);
  55.         }

  57.         /// <summary>
  58.         /// 获取一个时间戳，它是从1970年1月1日0时开始至现在的毫秒数
  59.         /// </summary>
  60.         /// <returns></returns>
  61.         public long GetTimeStamp()
  62.         {
  63.             TimeSpan ts = DateTime.Now - new DateTime(1970, 1, 1);
  64.             long timeStamp = (long)ts.TotalMilliseconds;
  65.             return timeStamp;
  66.         }


  69.         /// <summary>
  70.         /// 登录
  71.         /// </summary>
  72.         /// <param name="apID">你的用户ID</param>
  73.         /// <param name="apUserAccount">你的用户名</param>
  74.         /// <param name="funID">功能ID(短信或者呼叫等能力的编号)</param>
  75.         /// <param name="apKey">密钥</param>
  76.         public void Login(int apID, string apUserAccount, int funID, string apKey)
  77.         {
  78.             long timeStamp = this.GetTimeStamp();

  80.             //AuthRequestValue 格式如下：TimeStamp + “$” + APID+ “$” + APUserAccount + “$” + FunID + “$” + UrlEncode(Authenticator)，其中Authenticator的生成算法如下：Authenticator = Base64(SHA1 (TimeStamp + “$” + APID+ “$” + APUserAccount + “$” + FunID + “$” + APKEY))
  81.             string authenticator = EncryptToSHA1(string.Format("{0}${1}${2}${3}${4}", timeStamp, apID, apUserAccount, funID, apKey));
  82.             string authRequestValue = string.Format("{0}${1}${2}${3}${4}", timeStamp, apID, apUserAccount, funID, HttpUtility.UrlEncode(authenticator));

  84.             using (WebClient client = new WebClient())
  85.             {
  86.                 client.Encoding = Encoding.UTF8;
  87.                 string authResponseValue = client.DownloadString(string.Format("http://www.ctopen.cn/InterfaceForAP/Auth.aspx?AuthRequest={0}", authRequestValue));
  88.                 //AuthResponseValue格式如下：Result + “$”+ TransactionID + “$”+ Token+ “$” + ErrorDescription+ “$” + TimeStamp
  89.                 string[] resultArr = authResponseValue.Split(new char[] { '$' });
  90.                 int resultCode = int.Parse(resultArr[0]);
  91.                 if (resultCode == 0)
  92.                 {
  93.                     this.transactionID = resultArr[1];
  94.                     this.token = resultArr[2];
  95.                     timeStamp = long.Parse(resultArr[4]);
  96.                 }
  97.                 else
  98.                 {
  99.                     string errorDesc = resultArr[3];
  100.                     throw new Exception(errorDesc);
  101.                 }
  102.             }
  103.         }

  105.         /// <summary>
  106.         /// 打电话
  107.         /// </summary>
  108.         /// <param name="num1">第一呼叫号码(目前会听到广告)</param>
  109.         /// <param name="num2">第二呼叫号码</param>
  110.         /// <param name="num3"></param>
  111.         /// <param name="num4"></param>
  112.         /// <param name="num5"></param>
  113.         /// <returns>返回本次通话的会话ID，用于挂断电话</returns>
  114.         public string MakeCall(string num1, string num2, string num3, string num4, string num5)
  115.         {
  116.             string callbackUrl = "http://mail.loopc.com:443/CallReport.aspx";//用于记录通话时间等信息。查看费用请访问[url]http://mail.loopc.com:443/[/url]你的电话号码.txt
  117.             string safeCode = "";//好像没有作用。
  118.             long timeStamp = this.GetTimeStamp();//时间戳，用于计费
  119.             //用以标识唯一的呼叫，呼叫模块在中间计费或结束计费上报时将通过该字段上报。格式：第一呼叫号_时间戳(秒)_三位随机数
  120.             string sessionId = string.Format("{0}_{1}_{2}", num1, timeStamp, 123);//挂机时会用到

  122.             // 其中MakeCallRequestValue格式如下：Token+ “$” + Sessionid + “$” + Num1 + “$” + Num2+ “$”+Num3+ “$”+Num4+ “$”+Num5+ “$”+Code+ “$”+Url
  123.             string makeCallRequestValue = string.Format("{0}${1}${2}${3}${4}${5}${6}${7}${8}", this.token, sessionId, num1, num2, num3, num4, num5, safeCode, callbackUrl);
  124.             using (WebClient client = new WebClient())
  125.             {
  126.                 client.Encoding = Encoding.UTF8;
  127.                 string makeCallResponse = client.DownloadString(string.Format("http://118.123.249.4/ims/ghcall.php?MakeCallRequest={0}", makeCallRequestValue));
  128.                 ResultCode resultCode = (ResultCode)int.Parse(makeCallResponse);//200： 发送成功，403：非法请求_禁止发送,400：请求消息错误,480：请求失败
  129.                 if (resultCode != ResultCode.OK)
  130.                 {
  131.                     throw new Exception(resultCode.ToString());
  132.                 }
  133.                 return sessionId;
  134.             }
  135.         }

  137.         /// <summary>
  138.         /// 挂断电话
  139.         /// </summary>
  140.         /// <param name="sessioinId">打电话时的会话ID</param>
  141.         public void HangupCall(string sessioinId)
  142.         {
  143.             using (WebClient client = new WebClient())
  144.             {
  145.                 client.Encoding = Encoding.UTF8;
  146.                 string response = client.DownloadString(string.Format("http://118.123.249.4/ims/ghcall.php?HangupCallRequest={0}", sessioinId));
  147.                 ResultCode resultCode = (ResultCode)int.Parse(response);//挂断呼叫结果{200： 挂机成功,400：请求消息错误,480：请求失败}
  148.                 if (resultCode != ResultCode.OK)
  149.                 {
  150.                     throw new Exception(resultCode.ToString());
  151.                 }
  152.             }
  153.         }

  155.         /// <summary>
  156.         /// 发送短信给指定号码
  157.         /// </summary>
  158.         /// <param name="msg">消息内容（不超过70汉字，英文不能超过140字符）</param>
  159.         /// <param name="toNo">接收者号码</param>
  160.         public void SendMsg(string msg, string toNo)
  161.         {
  162.             string fromNo = "";//指定以电信的哪个号码发出去。
  163.             msg = GetBase64String(msg);
  164.             //SendMsgRequestValue=UrlEncode(Token+ “$” + Phone + “$” + Msg + “$” + From)
  165.             string sendMsgRequestValue = string.Format("{0}${1}${2}${3}", this.token, toNo, msg, fromNo);
  166.             sendMsgRequestValue = HttpUtility.UrlEncode(sendMsgRequestValue);

  168.             using (WebClient client = new WebClient())
  169.             {
  170.                 client.Encoding = Encoding.UTF8;
  171.                 string response = client.DownloadString(string.Format("http://118.123.249.4/ims/ghsendim.php?SendMsgRequest={0}", sendMsgRequestValue));
  172.                 response = response.Replace("SendMsgResponse=", "");//接口返回格式不统一，只好去除多余的字符。
  173.                 ResultCode resultCode = (ResultCode)int.Parse(response); //短信发送结果：{200： 发送成功,403：非法请求_禁止发送,400：请求消息错误}
  174.                 if (resultCode != ResultCode.OK)
  175.                 {
  176.                     throw new Exception(resultCode.ToString());
  177.                 }
  178.             }
  179.         }

  181.     }
  182. }
复制代码
测试代码
Program.cs：
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using System.Text;

  6. namespace Telephone
  7. {
  8.     class Program
  9.     {
  10.         static void Main(string[] args)
  11.         {
  12.             API api = new API();

  14.             api.Login(10000111, "xu123456", 10000033, "5e30d0303a874415ae641f227b5c29b6");  //登录

  16.             api.SendMsg("hello", "13500000001");//发短信

  18.             string sessionId = api.MakeCall("13500000001", "1350000002", null, null, null);//打电话，目前好像就支持两个人通话
  19.             Console.WriteLine(sessionId);

  21.             Console.WriteLine("press any key to hangup the call.");
  22.             Console.ReadLine();
  23.             api.HangupCall(sessionId);//挂断电话

  25.             Console.WriteLine("end.");
  26.             Console.ReadLine();
  27.         }
  28.     }
  29. }
复制代码
net200 - 2009/12/7 22:52:00
支持 ，这个需要跟电信申请什么么
admin - 2009/12/8 14:16:00
原帖由 net200 于 2009-12-7 22:52:00 发表
支持 ，这个需要跟电信申请什么么


对，需要到电信的网站注册账号就可以使用了。
电信能力开放平台网址：http://open.ctfactory.com/Portal/index/index.aspx
12
查看完整版本: C# 电信能力开放平台API
Powered by Discuz!NT Archiver 3.0.0 2001-2024 Comsenz Inc.