/// <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);
}
}
/// <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);
}
}