예제 #1
0
        /// <summary>
        /// You can experiment with initiating a call through Message360 and view the request response generated when doing so and get the response in json
        /// </summary>
        /// <param name="CreateMakeCallInput">Object containing request parameters</param>
        /// <return>Returns the string response from the API call</return>
        public async Task <string> CreateMakeCallAsync(CreateMakeCallInput input)
        {
            //validating required parameters
            if (null == input.FromCountryCode)
            {
                throw new ArgumentNullException("fromCountryCode", "The property \"FromCountryCode\" in the input object cannot be null.");
            }

            if (null == input.From)
            {
                throw new ArgumentNullException("mfrom", "The property \"From\" in the input object cannot be null.");
            }

            if (null == input.ToCountryCode)
            {
                throw new ArgumentNullException("toCountryCode", "The property \"ToCountryCode\" in the input object cannot be null.");
            }

            if (null == input.To)
            {
                throw new ArgumentNullException("to", "The property \"To\" in the input object cannot be null.");
            }

            if (null == input.Url)
            {
                throw new ArgumentNullException("url", "The property \"Url\" in the input object cannot be null.");
            }

            //the base uri for api requestss
            string _baseUri = Configuration.GetBaseURI();

            //prepare query string for API call
            StringBuilder _queryBuilder = new StringBuilder(_baseUri);

            _queryBuilder.Append("/calls/makecall.{ResponseType}");

            //process optional template parameters
            APIHelper.AppendUrlWithTemplateParameters(_queryBuilder, new Dictionary <string, object>()
            {
                { "ResponseType", input.ResponseType }
            });

            //process optional query parameters
            APIHelper.AppendUrlWithQueryParameters(_queryBuilder, new Dictionary <string, object>()
            {
                { "Method", (input.Method.HasValue) ? HttpActionHelper.ToValue(input.Method.Value) : null }
            });


            //validate and preprocess url
            string _queryUrl = APIHelper.CleanUrl(_queryBuilder);

            //append request with appropriate headers and parameters
            var _headers = new Dictionary <string, string>()
            {
                { "user-agent", "message360-api" }
            };

            //append form/field parameters
            var _fields = new Dictionary <string, object>()
            {
                { "FromCountryCode", input.FromCountryCode },
                { "From", input.From },
                { "ToCountryCode", input.ToCountryCode },
                { "To", input.To },
                { "Url", input.Url },
                { "StatusCallBackUrl", input.StatusCallBackUrl },
                { "StatusCallBackMethod", (input.StatusCallBackMethod.HasValue) ? HttpActionHelper.ToValue(input.StatusCallBackMethod.Value) : null },
                { "FallBackUrl", input.FallBackUrl },
                { "FallBackMethod", (input.FallBackMethod.HasValue) ? HttpActionHelper.ToValue(input.FallBackMethod.Value) : null },
                { "HeartBeatUrl", input.HeartBeatUrl },
                { "HeartBeatMethod", input.HeartBeatMethod },
                { "Timeout", input.Timeout },
                { "PlayDtmf", input.PlayDtmf },
                { "HideCallerId", input.HideCallerId },
                { "Record", input.Record },
                { "RecordCallBackUrl", input.RecordCallBackUrl },
                { "RecordCallBackMethod", (input.RecordCallBackMethod.HasValue) ? HttpActionHelper.ToValue(input.RecordCallBackMethod.Value) : null },
                { "Transcribe", input.Transcribe },
                { "TranscribeCallBackUrl", input.TranscribeCallBackUrl },
                { "IfMachine", (input.IfMachine.HasValue) ? IfMachineHelper.ToValue(input.IfMachine.Value) : null }
            };

            //prepare the API call request to fetch the response
            HttpRequest _request = ClientInstance.Post(_queryUrl, _headers, _fields, Configuration.BasicAuthUserName, Configuration.BasicAuthPassword);

            //invoke request and get response
            HttpStringResponse _response = (HttpStringResponse)await ClientInstance.ExecuteAsStringAsync(_request).ConfigureAwait(false);

            HttpContext _context = new HttpContext(_request, _response);

            //handle errors defined at the API level
            base.ValidateResponse(_response, _context);

            try
            {
                return(_response.Body);
            }
            catch (Exception _ex)
            {
                throw new APIException("Failed to parse the response: " + _ex.Message, _context);
            }
        }
예제 #2
0
        /// <summary>
        /// Send an SMS from a message360 number
        /// </summary>
        /// <param name="CreateSendSMSInput">Object containing request parameters</param>
        /// <return>Returns the string response from the API call</return>
        public async Task <string> CreateSendSMSAsync(CreateSendSMSInput input)
        {
            //validating required parameters
            if (null == input.From)
            {
                throw new ArgumentNullException("mfrom", "The property \"From\" in the input object cannot be null.");
            }

            if (null == input.To)
            {
                throw new ArgumentNullException("to", "The property \"To\" in the input object cannot be null.");
            }

            if (null == input.Body)
            {
                throw new ArgumentNullException("body", "The property \"Body\" in the input object cannot be null.");
            }

            //the base uri for api requestss
            string _baseUri = Configuration.GetBaseURI();

            //prepare query string for API call
            StringBuilder _queryBuilder = new StringBuilder(_baseUri);

            _queryBuilder.Append("/sms/sendsms.{ResponseType}");

            //process optional template parameters
            APIHelper.AppendUrlWithTemplateParameters(_queryBuilder, new Dictionary <string, object>()
            {
                { "ResponseType", input.ResponseType }
            });


            //validate and preprocess url
            string _queryUrl = APIHelper.CleanUrl(_queryBuilder);

            //append request with appropriate headers and parameters
            var _headers = new Dictionary <string, string>()
            {
                { "user-agent", "message360-api" }
            };

            //append form/field parameters
            var _fields = new Dictionary <string, object>()
            {
                { "fromcountrycode", input.Fromcountrycode },
                { "from", input.From },
                { "tocountrycode", input.Tocountrycode },
                { "to", input.To },
                { "body", input.Body },
                { "method", (input.Method.HasValue) ? HttpActionHelper.ToValue(input.Method.Value) : null },
                { "messagestatuscallback", input.Messagestatuscallback }
            };

            //prepare the API call request to fetch the response
            HttpRequest _request = ClientInstance.Post(_queryUrl, _headers, _fields, Configuration.BasicAuthUserName, Configuration.BasicAuthPassword);

            //invoke request and get response
            HttpStringResponse _response = (HttpStringResponse)await ClientInstance.ExecuteAsStringAsync(_request).ConfigureAwait(false);

            HttpContext _context = new HttpContext(_request, _response);

            //handle errors defined at the API level
            base.ValidateResponse(_response, _context);

            try
            {
                return(_response.Body);
            }
            catch (Exception _ex)
            {
                throw new APIException("Failed to parse the response: " + _ex.Message, _context);
            }
        }
        /// <summary>
        /// Update Phone Number Details
        /// </summary>
        /// <param name="UpdatePhoneNumberInput">Object containing request parameters</param>
        /// <return>Returns the string response from the API call</return>
        public async Task <string> UpdatePhoneNumberAsync(UpdatePhoneNumberInput input)
        {
            //validating required parameters
            if (null == input.PhoneNumber)
            {
                throw new ArgumentNullException("phoneNumber", "The property \"PhoneNumber\" in the input object cannot be null.");
            }

            //the base uri for api requestss
            string _baseUri = Configuration.GetBaseURI();

            //prepare query string for API call
            StringBuilder _queryBuilder = new StringBuilder(_baseUri);

            _queryBuilder.Append("/incomingphone/updatenumber.{ResponseType}");

            //process optional template parameters
            APIHelper.AppendUrlWithTemplateParameters(_queryBuilder, new Dictionary <string, object>()
            {
                { "ResponseType", input.ResponseType }
            });


            //validate and preprocess url
            string _queryUrl = APIHelper.CleanUrl(_queryBuilder);

            //append request with appropriate headers and parameters
            var _headers = new Dictionary <string, string>()
            {
                { "user-agent", "message360-api" }
            };

            //append form/field parameters
            var _fields = new Dictionary <string, object>()
            {
                { "PhoneNumber", input.PhoneNumber },
                { "FriendlyName", input.FriendlyName },
                { "VoiceUrl", input.VoiceUrl },
                { "VoiceMethod", (input.VoiceMethod.HasValue) ? HttpActionHelper.ToValue(input.VoiceMethod.Value) : null },
                { "VoiceFallbackUrl", input.VoiceFallbackUrl },
                { "VoiceFallbackMethod", (input.VoiceFallbackMethod.HasValue) ? HttpActionHelper.ToValue(input.VoiceFallbackMethod.Value) : null },
                { "HangupCallback", input.HangupCallback },
                { "HangupCallbackMethod", (input.HangupCallbackMethod.HasValue) ? HttpActionHelper.ToValue(input.HangupCallbackMethod.Value) : null },
                { "HeartbeatUrl", input.HeartbeatUrl },
                { "HeartbeatMethod", (input.HeartbeatMethod.HasValue) ? HttpActionHelper.ToValue(input.HeartbeatMethod.Value) : null },
                { "SmsUrl", input.SmsUrl },
                { "SmsMethod", (input.SmsMethod.HasValue) ? HttpActionHelper.ToValue(input.SmsMethod.Value) : null },
                { "SmsFallbackUrl", input.SmsFallbackUrl },
                { "SmsFallbackMethod", (input.SmsFallbackMethod.HasValue) ? HttpActionHelper.ToValue(input.SmsFallbackMethod.Value) : null }
            };

            //prepare the API call request to fetch the response
            HttpRequest _request = ClientInstance.Post(_queryUrl, _headers, _fields, Configuration.BasicAuthUserName, Configuration.BasicAuthPassword);

            //invoke request and get response
            HttpStringResponse _response = (HttpStringResponse)await ClientInstance.ExecuteAsStringAsync(_request).ConfigureAwait(false);

            HttpContext _context = new HttpContext(_request, _response);

            //handle errors defined at the API level
            base.ValidateResponse(_response, _context);

            try
            {
                return(_response.Body);
            }
            catch (Exception _ex)
            {
                throw new APIException("Failed to parse the response: " + _ex.Message, _context);
            }
        }