/// <summary> /// Create, print, and mail a letter to an address. The letter file must be supplied as a PDF or an HTML string. /// </summary> /// <param name="Models.CreateLetterCreateInput">Object containing request parameters</param> /// <return>Returns the string response from the API call</return> public string CreateLetterCreate(Models.CreateLetterCreateInput input) { Task <string> t = CreateLetterCreateAsync(input); APIHelper.RunTaskSynchronously(t); return(t.Result); }
/// <summary> /// Create, print, and mail a letter to an address. The letter file must be supplied as a PDF or an HTML string. /// </summary> /// <param name="Models.CreateLetterCreateInput">Object containing request parameters</param> /// <return>Returns the string response from the API call</return> public async Task <string> CreateLetterCreateAsync(Models.CreateLetterCreateInput input) { //the base uri for api requests string _baseUri = Configuration.BaseUri; //prepare query string for API call StringBuilder _queryBuilder = new StringBuilder(_baseUri); _queryBuilder.Append("/letter/create.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>("to", input.To), new KeyValuePair <string, object>("from", input.From), new KeyValuePair <string, object>("attachbyid", input.Attachbyid), new KeyValuePair <string, object>("file", input.File), new KeyValuePair <string, object>("color", input.Color), new KeyValuePair <string, object>("description", input.Description), new KeyValuePair <string, object>("extraservice", input.Extraservice), new KeyValuePair <string, object>("doublesided", input.Doublesided), new KeyValuePair <string, object>("template", input.Template), new KeyValuePair <string, object>("htmldata", input.Htmldata) }; //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); } }