更新时间:2023-01-13 GMT+08:00
分享

AXYB模式

样例

AXYB模式绑定接口

AXYB模式解绑接口

AXYB模式绑定信息查询接口

获取录音文件下载地址接口

呼叫事件通知接口

话单通知接口

环境要求

基于.NET Core SDK 2.1.401版本,要求.NET Core 2.0及以上版本或.NET Framework 4.7.1及以上版本。

引用库

Newtonsoft.Json 11.0.2,请参考https://www.newtonsoft.com/json获取。

  • 本文档所述Demo在提供服务的过程中,可能会涉及个人数据的使用,建议您遵从国家的相关法律采取足够的措施,以确保用户的个人数据受到充分的保护。
  • 本文档所述Demo仅用于功能演示,不允许客户直接进行商业使用。
  • 本文档信息仅供参考,不构成任何要约或承诺。
  • 本文档接口携带参数只是用作参考,不可以直接复制使用,填写参数需要替换为实际值,请参考“开发准备”获取所需数据。

AXYB模式绑定接口

  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
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Collections.Specialized;
using System.IO;
using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Net.Security;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using System.Text;

namespace privatenumber_axyb_csharp_demo
{
    class xyBind
    {
        static void Main(string[] args)
        {
            //必填,请参考"开发准备"获取如下数据,替换为实际值
            string apiAddress = "https://rtcpns.cn-north-1.myhuaweicloud.com/rest/omp/xyrelationnumber/v1.0"; //APP接入地址+接口访问URI
            string appKey = "a1********"; //APP_Key
            string appSecret = "cfc8********"; //APP_Secret
            string origNum_A = "+86186****5678"; //用户号码A
            string origNum_B = "+86186****5679"; //用户号码B

            /*
             * 选填,各参数要求请参考"AXYB模式绑定接口"
             */
            string areaCode = "0755"; //区号,标示隐私号归属的区域
            //string areaMatchMode = "0"; // 号码筛选方式
            string subscriptionId = "****"; // 绑定关系ID
            //int callDirection = 0; // 允许的呼叫方向
            //int duration = 7200; // 绑定关系保持时间(单位为秒)
            //var recordFlag = true; // 录音标识
            //string recordHintTone = "recordHintTone.wav"; // 录音提示音
            //string preVoiceX = "x_hint_tone1.wav"; // 设置对X号码播放的个性化通话前等待音
            //string preVoiceY = "y_hint_tone1.wav"; // 设置对Y号码播放的个性化通话前等待音

            FileStream fs = File.Open("bind_data.txt", FileMode.Append); //打开文件
            try
            {
                //为防止因HTTPS证书认证失败造成API调用失败,需要先忽略证书信任问题
                //.NET Framework 4.7.1及以上版本,请采用如下代码
                //var sslHandler = new HttpClientHandler()
                //{
                //    ServerCertificateCustomValidationCallback = (message, cert, chain, err) => { return true; }
                //};
                //HttpClient client = new HttpClient(sslHandler, true);
                //低于.NET Framework 4.7.1版本,请采用如下代码
                HttpClient client = new HttpClient();
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);

                //请求Headers
                client.DefaultRequestHeaders.Add("Authorization", "AKSK realm=\"SDP\",profile=\"UsernameToken\",type=\"Appkey\"");
                client.DefaultRequestHeaders.Add("X-AKSK", buildAKSKHeader(appKey, appSecret));
                //请求url参数
                var keyValues = new NameValueCollection();
                keyValues.Add("app_key", appKey);
                //完整请求地址
                var url = apiAddress + "?" + buildQueryString(keyValues);
                //先绑定AX,获取subscriptionId
                var body = new Dictionary<string, object>() {
                    {"origNum", origNum_A},
                    {"areaCode", areaCode},
                    //{"areaMatchMode", areaMatchMode},
                    //{"callDirection", callDirection},
                    //{"duration", duration},
                    //{"recordFlag", recordFlag},
                    //{"recordHintTone", recordHintTone},
                    //{"preVoiceX", preVoiceX}
                };
                //再携带subscriptionId,绑定YB,确认AXYB
                //var body = new Dictionary<string, object>() {
                //    {"origNum", origNum_B},
                //    //{"areaCode", areaCode},
                //    //{"areaMatchMode", areaMatchMode},
                //    {"subscriptionId", subscriptionId},
                //    //{"preVoiceY", preVoiceY}
                //};

                HttpContent content = new StringContent(JsonConvert.SerializeObject(body));
                //请求Headers中的Content-Type参数
                content.Headers.ContentType = new MediaTypeHeaderValue("application/json");

                byte[] bbody = Encoding.Default.GetBytes("绑定请求数据:" + JsonConvert.SerializeObject(body) + "\r\n");
                fs.Write(bbody, 0, bbody.Length); //绑定请求参数记录到本地文件,方便定位问题

                var response = client.PostAsync(url, content).Result; //POST请求
                Console.WriteLine(response.StatusCode);
                var res = response.Content.ReadAsStringAsync().Result;
                Console.WriteLine(res); //打印响应数据
                byte[] bres = Encoding.Default.GetBytes("绑定结果:" + res + "\r\n");
                fs.Write(bres, 0, bres.Length); //绑定ID很重要,请记录到本地文件
            }
            catch (Exception e)
            {
                Console.WriteLine(e.StackTrace);
                Console.WriteLine(e.Message); //打印错误信息
            }
            finally
            {
                fs.Close(); //关闭文件
            }
        }

        static string buildAKSKHeader(string appKey, string appSecret)
        {
            string now = DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ"); //Created
            string nonce = Guid.NewGuid().ToString().Replace("-", ""); //Nonce
            String str = nonce + now;

            byte[] keyByte = Encoding.UTF8.GetBytes(appSecret);
            byte[] messageBytes = Encoding.UTF8.GetBytes(str);
            using (var hmacsha256 = new HMACSHA256(keyByte))
            {
                byte[] hashmessage = hmacsha256.ComputeHash(messageBytes);
                string base64 = Convert.ToBase64String(hashmessage);
                return String.Format("UsernameToken Username=\"{0}\",PasswordDigest=\"{1}\",Nonce=\"{2}\",Created=\"{3}\"",
                    appKey, base64, nonce, now);
            }
        }

        //低于.NET Framework 4.7.1版本,启用如下方法
        static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
        {
            return true;
        }
    }
}

AXYB模式解绑接口

  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
using System;
using System.Collections.Specialized;
using System.Net;
using System.Net.Http;
using System.Net.Security;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using System.Text;

namespace privatenumber_axyb_csharp_demo
{
    class xyUnbind
    {
        static void Main(string[] args)
        {
            //必填,请参考"开发准备"获取如下数据,替换为实际值
            string apiAddress = "https://rtcpns.cn-north-1.myhuaweicloud.com/rest/omp/xyrelationnumber/v1.0"; //APP接入地址+接口访问URI
            string appKey = "a1********"; //APP_Key
            string appSecret = "cfc8********"; //APP_Secret

            /*
             * 必填,参数要求请参考"AXYB模式解绑接口"
             */
            string subscriptionId = "****"; //指定"AXYB模式绑定接口"返回的绑定ID进行解绑

            try
            {
                //为防止因HTTPS证书认证失败造成API调用失败,需要先忽略证书信任问题
                //.NET Framework 4.7.1及以上版本,请采用如下代码
                //var sslHandler = new HttpClientHandler()
                //{
                //    ServerCertificateCustomValidationCallback = (message, cert, chain, err) => { return true; }
                //};
                //HttpClient client = new HttpClient(sslHandler, true);
                //低于.NET Framework 4.7.1版本,请采用如下代码
                HttpClient client = new HttpClient();
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);

                //请求Headers
                client.DefaultRequestHeaders.Add("Authorization", "AKSK realm=\"SDP\",profile=\"UsernameToken\",type=\"Appkey\"");
                client.DefaultRequestHeaders.Add("X-AKSK", buildAKSKHeader(appKey, appSecret));
                //请求url参数
                var keyValues = new NameValueCollection();
                keyValues.Add("subscriptionId", subscriptionId);
                keyValues.Add("app_key", appKey);
                //完整请求地址
                var url = apiAddress + "?" + buildQueryString(keyValues);

                Console.WriteLine(buildQueryString(keyValues)); //打印请求数据
                var response = client.DeleteAsync(url).Result; //DELETE请求
                Console.WriteLine(response.StatusCode);
                var res = response.Content.ReadAsStringAsync().Result;
                Console.WriteLine(res); //打印响应结果
            }
            catch (Exception e)
            {
                Console.WriteLine(e.StackTrace);
                Console.WriteLine(e.Message); //打印错误信息
            }
        }

        /// <summary>
        /// 构造请求url参数
        /// </summary>
        /// <param name="keyValues"></param>
        /// <returns></returns>
        static string buildQueryString(NameValueCollection keyValues)
        {
            StringBuilder temp = new StringBuilder();
            foreach (string item in keyValues.Keys)
            {
                temp.Append(item).Append("=").Append(WebUtility.UrlEncode(keyValues.Get(item))).Append("&");
            }
            return temp.Remove(temp.Length - 1, 1).ToString();
        }

        static string buildAKSKHeader(string appKey, string appSecret)
        {
            string now = DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ"); //Created
            string nonce = Guid.NewGuid().ToString().Replace("-", ""); //Nonce
            String str = nonce + now;

            byte[] keyByte = Encoding.UTF8.GetBytes(appSecret);
            byte[] messageBytes = Encoding.UTF8.GetBytes(str);
            using (var hmacsha256 = new HMACSHA256(keyByte))
            {
                byte[] hashmessage = hmacsha256.ComputeHash(messageBytes);
                string base64 = Convert.ToBase64String(hashmessage);
                return String.Format("UsernameToken Username=\"{0}\",PasswordDigest=\"{1}\",Nonce=\"{2}\",Created=\"{3}\"",
                    appKey, base64, nonce, now);
            }
        }

        //低于.NET Framework 4.7.1版本,启用如下方法
        static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
        {
            return true;
        }
    }
}

AXYB模式绑定信息查询接口

  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
using System;
using System.Collections.Specialized;
using System.IO;
using System.Net;
using System.Net.Http;
using System.Net.Security;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using System.Text;

namespace privatenumber_axyb_csharp_demo
{
    class xyQueryBind
    {
        static void Main(string[] args)
        {
            //必填,请参考"开发准备"获取如下数据,替换为实际值
            string apiAddress = "https://rtcpns.cn-north-1.myhuaweicloud.com/rest/omp/xyrelationnumber/v1.0"; //APP接入地址+接口访问URI
            string appKey = "a1********"; //APP_Key
            string appSecret = "cfc8********"; //APP_Secret

            /*
             * 选填,各参数要求请参考"AXYB模式绑定信息查询接口"
             * subscriptionId和relationNum为二选一关系,两者都携带时以subscriptionId为准
             */
            string relationNum = "+86186****5678"; //指定X号码进行查询
            string subscriptionId = "****"; //指定"AXYB模式绑定接口"返回的绑定ID进行查询

            FileStream fs = File.Open("bind_data.txt", FileMode.Append); //打开文件
            try
            {
                //为防止因HTTPS证书认证失败造成API调用失败,需要先忽略证书信任问题
                //.NET Framework 4.7.1及以上版本,请采用如下代码
                //var sslHandler = new HttpClientHandler()
                //{
                //    ServerCertificateCustomValidationCallback = (message, cert, chain, err) => { return true; }
                //};
                //HttpClient client = new HttpClient(sslHandler, true);
                //低于.NET Framework 4.7.1版本,请采用如下代码
                HttpClient client = new HttpClient();
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);

                //请求Headers
                client.DefaultRequestHeaders.Add("Authorization", "AKSK realm=\"SDP\",profile=\"UsernameToken\",type=\"Appkey\"");
                client.DefaultRequestHeaders.Add("X-AKSK", buildAKSKHeader(appKey, appSecret));
                //请求url参数
                var keyValues = new NameValueCollection();
                keyValues.Add("subscriptionId", subscriptionId);
                keyValues.Add("relationNum", relationNum);
                keyValues.Add("app_key", appKey);
                //完整请求地址
                var url = apiAddress + "?" + buildQueryString(keyValues);

                var response = client.GetAsync(url).Result; //GET请求
                Console.WriteLine(response.StatusCode);
                var res = response.Content.ReadAsStringAsync().Result;
                Console.WriteLine(res); //打印响应结果
                byte[] bres = Encoding.Default.GetBytes("绑定查询结果:" + res + "\r\n");
                fs.Write(bres, 0, bres.Length); //查询结果,记录到本地文件
            }
            catch (Exception e)
            {
                Console.WriteLine(e.StackTrace);
                Console.WriteLine(e.Message); //打印错误信息
            }
            finally
            {
                fs.Close(); //关闭文件
            }
        }

        /// <summary>
        /// 构造请求url参数
        /// </summary>
        /// <param name="keyValues"></param>
        /// <returns></returns>
        static string buildQueryString(NameValueCollection keyValues)
        {
            StringBuilder temp = new StringBuilder();
            foreach (string item in keyValues.Keys)
            {
                temp.Append(item).Append("=").Append(WebUtility.UrlEncode(keyValues.Get(item))).Append("&");
            }
            return temp.Remove(temp.Length - 1, 1).ToString();
        }

        static string buildAKSKHeader(string appKey, string appSecret)
        {
            string now = DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ"); //Created
            string nonce = Guid.NewGuid().ToString().Replace("-", ""); //Nonce
            String str = nonce + now;

            byte[] keyByte = Encoding.UTF8.GetBytes(appSecret);
            byte[] messageBytes = Encoding.UTF8.GetBytes(str);
            using (var hmacsha256 = new HMACSHA256(keyByte))
            {
                byte[] hashmessage = hmacsha256.ComputeHash(messageBytes);
                string base64 = Convert.ToBase64String(hashmessage);
                return String.Format("UsernameToken Username=\"{0}\",PasswordDigest=\"{1}\",Nonce=\"{2}\",Created=\"{3}\"",
                    appKey, base64, nonce, now);
            }
        }

        //低于.NET Framework 4.7.1版本,启用如下方法
        static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
        {
            return true;
        }
    }
}

获取录音文件下载地址接口

  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
using System;
using System.Collections.Specialized;
using System.IO;
using System.Net;
using System.Net.Http;
using System.Net.Security;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using System.Text;

namespace privatenumber_axyb_csharp_demo
{
    class xyGetRecordLink
    {
        static void Main(string[] args)
        {
            //必填,请参考"开发准备"获取如下数据,替换为实际值
            string apiAddress = "https://rtcpns.cn-north-1.myhuaweicloud.com/rest/provision/voice/record/v1.0"; //APP接入地址+接口访问URI
            string appKey = "a1********"; //APP_Key
            string appSecret = "cfc8********"; //APP_Secret

            //必填,通过"话单通知接口"获取
            string fileName = "****.wav"; //录音文件名
            string recordDomain = "****.com"; //录音文件存储的服务器域名

            FileStream fs = File.Open("bind_data.txt", FileMode.Append); //打开文件
            try
            {
                //为防止因HTTPS证书认证失败造成API调用失败,需要先忽略证书信任问题
                //.NET Framework 4.7.1及以上版本,请采用如下代码
                //var sslHandler = new HttpClientHandler()
                //{
                //    ServerCertificateCustomValidationCallback = (message, cert, chain, err) => { return true; }
                //};
                //sslHandler.AllowAutoRedirect = false; //关闭重定向
                //HttpClient client = new HttpClient(sslHandler, true);
                //低于.NET Framework 4.7.1版本,请采用如下代码
                var sslHandler = new HttpClientHandler();
                sslHandler.AllowAutoRedirect = false;
                HttpClient client = new HttpClient(sslHandler);
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);

                //请求Headers
                client.DefaultRequestHeaders.Add("Authorization", "AKSK realm=\"SDP\",profile=\"UsernameToken\",type=\"Appkey\"");
                client.DefaultRequestHeaders.Add("X-AKSK", buildAKSKHeader(appKey, appSecret));
                //请求url参数
                var keyValues = new NameValueCollection();
                keyValues.Add("fileName", fileName);
                keyValues.Add("recordDomain", recordDomain);
                //完整请求地址
                var url = apiAddress + "?" + buildQueryString(keyValues);

                var response = client.GetAsync(url).Result; //GET请求
                if (response.StatusCode.Equals(301))
                {
                    var slink = Convert.ToString(response.Headers.GetValues("Location"));
                    Console.WriteLine(slink);
                    byte[] blink = Encoding.Default.GetBytes("获取录音文件下载地址:" + slink + "\r\n");
                    fs.Write(blink, 0, blink.Length); //查询结果,记录到本地文件
                }
                else
                {
                    var res = response.Content.ReadAsStringAsync().Result;
                    Console.WriteLine(response.StatusCode);
                    Console.WriteLine(res); //打印响应结果
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.StackTrace);
                Console.WriteLine(e.Message); //打印错误信息
            }
            finally
            {
                fs.Close(); //关闭文件
            }
        }

        /// <summary>
        /// 构造请求url参数
        /// </summary>
        /// <param name="keyValues"></param>
        /// <returns></returns>
        static string buildQueryString(NameValueCollection keyValues)
        {
            StringBuilder temp = new StringBuilder();
            foreach (string item in keyValues.Keys)
            {
                temp.Append(item).Append("=").Append(WebUtility.UrlEncode(keyValues.Get(item))).Append("&");
            }
            return temp.Remove(temp.Length - 1, 1).ToString();
        }

        static string buildAKSKHeader(string appKey, string appSecret)
        {
            string now = DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ"); //Created
            string nonce = Guid.NewGuid().ToString().Replace("-", ""); //Nonce
            String str = nonce + now;

            byte[] keyByte = Encoding.UTF8.GetBytes(appSecret);
            byte[] messageBytes = Encoding.UTF8.GetBytes(str);
            using (var hmacsha256 = new HMACSHA256(keyByte))
            {
                byte[] hashmessage = hmacsha256.ComputeHash(messageBytes);
                string base64 = Convert.ToBase64String(hashmessage);
                return String.Format("UsernameToken Username=\"{0}\",PasswordDigest=\"{1}\",Nonce=\"{2}\",Created=\"{3}\"",
                    appKey, base64, nonce, now);
            }
        }

        //低于.NET Framework 4.7.1版本,启用如下方法
        static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
        {
            return true;
        }
    }
}

呼叫事件通知接口

  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
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;

namespace privatenumber_axyb_csharp_demo
{
    class callEventImpl
    {
        static void Main(string[] args)
        {
            //呼叫事件通知样例
            string jsonBody = JsonConvert.SerializeObject(new Dictionary<string, object>(){
                {"eventType", "disconnect"},
                {"statusInfo", new Dictionary<string, object>(){
                        {"sessionId", "1200_1827_4294967295_20190124023003@callenabler246.huaweicaas.com"},
                        {"timestamp", "2019-01-24 02:30:22"},
                        {"caller", "+86138****0022"},
                        {"called", "+86138****7021"},
                        {"stateCode", 0},
                        {"stateDesc", "The user releases the call."},
                        {"subscriptionId", "****"}
                    }
                }
            });

            Console.WriteLine("jsonBody:" + jsonBody);

            //呼叫事件处理
            OnCallEvent(jsonBody);
        }

        /// <summary>
        /// 呼叫事件通知,详细内容以接口文档为准
        /// </summary>
        /// <param name="jsonBody"></param>
        static void OnCallEvent(string jsonBody)
        {
            JObject jsonObj = (JObject)JsonConvert.DeserializeObject(jsonBody); //将通知消息解析为jsonObj
            string eventType = jsonObj["eventType"].ToString(); //通知事件类型

            if ("fee".Equals(eventType))
            {
                Console.WriteLine("EventType error:" + eventType);
                return;
            }

            if (!jsonObj.ContainsKey("statusInfo"))
            {
                Console.WriteLine("param error: no statusInfo.");
                return;
            }
            JObject statusInfo = (JObject)jsonObj["statusInfo"]; //呼叫状态事件信息

            Console.WriteLine("eventType:" + eventType); //打印通知事件类型
            //callin:呼入事件
            if ("callin".Equals(eventType))
            {
                /**
                 * Example: 此处以解析sessionId为例,请按需解析所需参数并自行实现相关处理
                 *
                 * 'timestamp': 呼叫事件发生时隐私保护通话平台的UNIX时间戳
                 * 'sessionId': 通话链路的标识ID
                 * 'caller': 主叫号码
                 * 'called': 被叫号码
                 * 'subscriptionId': 绑定关系ID
                 */
                if (statusInfo.ContainsKey("sessionId"))
                {
                    Console.WriteLine("sessionId:" + statusInfo["sessionId"]);
                }
                return;
            }
            //callout:呼出事件
            if ("callout".Equals(eventType))
            {
                /**
                 * Example: 此处以解析sessionId为例,请按需解析所需参数并自行实现相关处理
                 *
                 * 'timestamp': 呼叫事件发生时隐私保护通话平台的UNIX时间戳
                 * 'sessionId': 通话链路的标识ID
                 * 'caller': 主叫号码
                 * 'called': 被叫号码
                 * 'subscriptionId': 绑定关系ID
                 */
                if (statusInfo.ContainsKey("sessionId"))
                {
                    Console.WriteLine("sessionId:" + statusInfo["sessionId"]);
                }
                return;
            }
            //alerting:振铃事件
            if ("alerting".Equals(eventType))
            {
                /**
                 * Example: 此处以解析sessionId为例,请按需解析所需参数并自行实现相关处理
                 *
                 * 'timestamp': 呼叫事件发生时隐私保护通话平台的UNIX时间戳
                 * 'sessionId': 通话链路的标识ID
                 * 'caller': 主叫号码
                 * 'called': 被叫号码
                 * 'subscriptionId': 绑定关系ID
                 */
                if (statusInfo.ContainsKey("sessionId"))
                {
                    Console.WriteLine("sessionId:" + statusInfo["sessionId"]);
                }
                return;
            }
            //answer:应答事件
            if ("answer".Equals(eventType))
            {
                /**
                 * Example: 此处以解析sessionId为例,请按需解析所需参数并自行实现相关处理
                 *
                 * 'timestamp': 呼叫事件发生时隐私保护通话平台的UNIX时间戳
                 * 'sessionId': 通话链路的标识ID
                 * 'caller': 主叫号码
                 * 'called': 被叫号码
                 * 'subscriptionId': 绑定关系ID
                 */
                if (statusInfo.ContainsKey("sessionId"))
                {
                    Console.WriteLine("sessionId:" + statusInfo["sessionId"]);
                }
                return;
            }
            //disconnect:挂机事件
            if ("disconnect".Equals(eventType))
            {
                /**
                 * Example: 此处以解析sessionId为例,请按需解析所需参数并自行实现相关处理
                 *
                 * 'timestamp': 呼叫事件发生时隐私保护通话平台的UNIX时间戳
                 * 'sessionId': 通话链路的标识ID
                 * 'caller': 主叫号码
                 * 'called': 被叫号码
                 * 'stateCode': 通话挂机的原因值
                 * 'stateDesc': 通话挂机的原因值的描述
                 * 'subscriptionId': 绑定关系ID
                 */
                if (statusInfo.ContainsKey("sessionId"))
                {
                    Console.WriteLine("sessionId:" + statusInfo["sessionId"]);
                }
                return;
            }
        }
    }
}

话单通知接口

  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
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;

namespace privatenumber_axyb_csharp_demo
{
    class feeImpl
    {
        static void Main(string[] args)
        {
            //话单通知样例
            string jsonBody = JsonConvert.SerializeObject(new Dictionary<string, object>(){
                {"eventType", "fee"},
                {"feeLst",  new object[] {
                    new Dictionary<string, object>(){
                            {"direction", 1},
                            {"spId", "****"},
                            {"appKey", "****"},
                            {"icid", "ba171f34e6953fcd751edc77127748f4.3757285803.338666679.5"},
                            {"bindNum", "+86138****0022"},
                            {"sessionId", "1200_1827_4294967295_20190124023003@callenabler246.huaweicaas.com"},
                            {"subscriptionId", "****"},
                            {"callerNum", "+86138****0021"},
                            {"calleeNum", "+86138****0022"},
                            {"fwdDisplayNum", "+86138****0022"},
                            {"fwdDstNum", "+86138****7021"},
                            {"callInTime", "2019-01-24 02:30:03"},
                            {"fwdStartTime", "2019-01-24 02:30:03"},
                            {"fwdAlertingTime", "2019-01-24 02:30:04"},
                            {"fwdAnswerTime", "2019-01-24 02:30:06"},
                            {"callEndTime", "2019-01-24 02:30:22"},
                            {"fwdUnaswRsn", 0},
                            {"ulFailReason", 0},
                            {"sipStatusCode", 0},
                            {"callOutUnaswRsn", 0},
                            {"recordFlag", 1},
                            {"recordStartTime", "2019-01-24 02:30:06"},
                            {"recordDomain", "****.com"},
                            {"recordBucketName", "****"},
                            {"recordObjectName", "****.wav"},
                            {"ttsPlayTimes", 0},
                            {"ttsTransDuration", 0},
                            {"mptyId", "****"},
                            {"serviceType", "003"},
                            {"hostName", "callenabler246.huaweicaas.com"}
                        }
                    }
                }
            });

            Console.WriteLine("jsonBody:" + jsonBody);

            //话单处理
            OnFeeEvent(jsonBody);
        }

        /// <summary>
        /// 话单通知,详细内容以接口文档为准
        /// </summary>
        /// <param name="jsonBody"></param>
        static void OnFeeEvent(string jsonBody)
        {
            JObject jsonObj = (JObject)JsonConvert.DeserializeObject(jsonBody); //将通知消息解析为jsonObj
            string eventType = jsonObj["eventType"].ToString(); //通知事件类型

            if (!"fee".Equals(eventType))
            {
                Console.WriteLine("EventType error:" + eventType);
                return;
            }

            if (!jsonObj.ContainsKey("feeLst"))
            {
                Console.WriteLine("param error: no feeLst.");
                return;
            }
            JObject[] feeLst = jsonObj["feeLst"].ToObject<JObject[]>(); //呼叫话单事件信息
            /**
             * Example: 此处以解析sessionId为例,请按需解析所需参数并自行实现相关处理
             *
             * 'direction': 通话的呼叫方向
             * 'spId': 客户的云服务账号
             * 'appKey': 商户应用的AppKey
             * 'icid': 呼叫记录的唯一标识
             * 'bindNum': 隐私保护号码
             * 'sessionId': 通话链路的唯一标识
             * 'callerNum': 主叫号码
             * 'calleeNum': 被叫号码
             * 'fwdDisplayNum': 转接呼叫时的显示号码
             * 'fwdDstNum': 转接呼叫时的转接号码
             * 'callInTime': 呼入的开始时间
             * 'fwdStartTime': 转接呼叫操作的开始时间
             * 'fwdAlertingTime': 转接呼叫操作后的振铃时间
             * 'fwdAnswerTime': 转接呼叫操作后的应答时间
             * 'callEndTime': 呼叫结束时间
             * 'fwdUnaswRsn': 转接呼叫操作失败的Q850原因值
             * 'failTime': 呼入,呼出的失败时间
             * 'ulFailReason': 通话失败的拆线点
             * 'sipStatusCode': 呼入,呼出的失败SIP状态码
             * 'recordFlag': 录音标识
             * 'recordStartTime': 录音开始时间
             * 'recordObjectName': 录音文件名
             * 'recordBucketName': 录音文件所在的目录名
             * 'recordDomain': 存放录音文件的域名
             * 'serviceType': 携带呼叫的业务类型信息
             * 'hostName': 话单生成的服务器设备对应的主机名
             * 'subscriptionId': 绑定关系ID
             */
            //短时间内有多个通话结束时隐私保护通话平台会将话单合并推送,每条消息最多携带50个话单
            if (feeLst.Length > 1)
            {
                foreach (JObject loop in feeLst)
                {
                    if (loop.ContainsKey("sessionId"))
                    {
                        Console.WriteLine("sessionId:" + loop["sessionId"]);
                    }
                }
            }
            else if (feeLst.Length == 1)
            {
                if (feeLst[0].ContainsKey("sessionId"))
                {
                    Console.WriteLine("sessionId:" + feeLst[0]["sessionId"]);
                }
            }
            else
            {
                Console.WriteLine("feeLst error: no element.");
            }
        }
    }
}
分享:

    相关文档

    相关产品