/// <summary>
/// Purchase a selected number of DID's from specific area codes to be used with your Ytel account.
/// </summary>
/// <param name="numberType">Required parameter: The capability the number supports.</param>
/// <param name="areaCode">Required parameter: Specifies the area code for the returned list of available numbers. Only available for North American numbers.</param>
/// <param name="quantity">Required parameter: A positive integer that tells how many number you want to buy at a time.</param>
/// <param name="leftover">Optional parameter: If desired quantity is unavailable purchase what is available .</param>
/// <return>Returns the string response from the API call</return>
public async Task <string> CreateBulkBuyNumbersAsync(
Models.NumberType15Enum numberType,
string areaCode,
string quantity,
string leftover = null)
{
//the base uri for api requests
string _baseUri = Configuration.BaseUri;
//prepare query string for API call
StringBuilder _queryBuilder = new StringBuilder(_baseUri);
_queryBuilder.Append("/incomingphone/bulkbuy.json");
//validate and preprocess url
string _queryUrl = APIHelper.CleanUrl(_queryBuilder);
//append request with appropriate headers and parameters
var _headers = new Dictionary <string, string>()
{
{ "user-agent", "APIMATIC 2.0" }
};
//append form/field parameters
var _fields = new List <KeyValuePair <string, Object> >()
{
new KeyValuePair <string, object>("NumberType", Models.NumberType15EnumHelper.ToValue(numberType)),
new KeyValuePair <string, object>("AreaCode", areaCode),
new KeyValuePair <string, object>("Quantity", quantity),
new KeyValuePair <string, object>("Leftover", leftover)
};
//remove null parameters
_fields = _fields.Where(kvp => kvp.Value != null).ToList();
//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>
/// Purchase a selected number of DID's from specific area codes to be used with your Ytel account.
/// </summary>
/// <param name="numberType">Required parameter: The capability the number supports.</param>
/// <param name="areaCode">Required parameter: Specifies the area code for the returned list of available numbers. Only available for North American numbers.</param>
/// <param name="quantity">Required parameter: A positive integer that tells how many number you want to buy at a time.</param>
/// <param name="leftover">Optional parameter: If desired quantity is unavailable purchase what is available .</param>
/// <return>Returns the string response from the API call</return>
public string CreateBulkBuyNumbers(
Models.NumberType15Enum numberType,
string areaCode,
string quantity,
string leftover = null)
{
Task <string> t = CreateBulkBuyNumbersAsync(numberType, areaCode, quantity, leftover);
APIHelper.RunTaskSynchronously(t);
return(t.Result);
}