/// <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 string CreateMakeCall(CreateMakeCallInput input)
{
Task <string> t = CreateMakeCallAsync(input);
APIHelper.RunTaskSynchronously(t);
return(t.Result);
}
/// <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);
}
}