/// <summary>
/// Uploads a file to use as evidence in a dispute challenge. The endpoint accepts HTTP.
/// multipart/form-data file uploads in HEIC, HEIF, JPEG, PDF, PNG, and TIFF formats..
/// </summary>
/// <param name="disputeId">Required parameter: The ID of the dispute you want to upload evidence for..</param>
/// <param name="request">Optional parameter: Defines the parameters for a `CreateDisputeEvidenceFile` request..</param>
/// <param name="imageFile">Optional parameter: Example: .</param>
/// <returns>Returns the Models.CreateDisputeEvidenceFileResponse response from the API call.</returns>
public Models.CreateDisputeEvidenceFileResponse CreateDisputeEvidenceFile(
string disputeId,
Models.CreateDisputeEvidenceFileRequest request = null,
FileStreamInfo imageFile = null)
{
Task <Models.CreateDisputeEvidenceFileResponse> t = this.CreateDisputeEvidenceFileAsync(disputeId, request, imageFile);
ApiHelper.RunTaskSynchronously(t);
return(t.Result);
}
/// <summary>
/// Uploads a file to use as evidence in a dispute challenge. The endpoint accepts
/// HTTP multipart/form-data file uploads in HEIC, HEIF, JPEG, PDF, PNG,
/// and TIFF formats.
/// </summary>
/// <param name="disputeId">Required parameter: ID of the dispute you want to upload evidence for.</param>
/// <param name="request">Optional parameter: Defines parameters for a CreateDisputeEvidenceFile request.</param>
/// <param name="imageFile">Optional parameter: Example: </param>
/// <return>Returns the Models.CreateDisputeEvidenceFileResponse response from the API call</return>
public async Task <Models.CreateDisputeEvidenceFileResponse> CreateDisputeEvidenceFileAsync(string disputeId, Models.CreateDisputeEvidenceFileRequest request = null, FileStreamInfo imageFile = null, CancellationToken cancellationToken = default)
{
//the base uri for api requests
string _baseUri = config.GetBaseUri();
//prepare query string for API call
StringBuilder _queryBuilder = new StringBuilder(_baseUri);
_queryBuilder.Append("/v2/disputes/{dispute_id}/evidence_file");
//process optional template parameters
ApiHelper.AppendUrlWithTemplateParameters(_queryBuilder, new Dictionary <string, object>()
{
{ "dispute_id", disputeId }
});
//validate and preprocess url
string _queryUrl = ApiHelper.CleanUrl(_queryBuilder);
//append request with appropriate headers and parameters
var _headers = new Dictionary <string, string>()
{
{ "user-agent", userAgent },
{ "accept", "application/json" },
{ "Square-Version", config.SquareVersion }
};
var requestHeaders = new Dictionary <string, IReadOnlyCollection <string> >(StringComparer.OrdinalIgnoreCase)
{
{ "Content-Type", new [] { "application/json; charset=utf-8" } }
};
var imageFileHeaders = new Dictionary <string, IReadOnlyCollection <string> >(StringComparer.OrdinalIgnoreCase)
{
{ "Content-Type", new [] { string.IsNullOrEmpty(imageFile.ContentType) ? "image/jpeg" : imageFile.ContentType } }
};
//append form/field parameters
var _fields = new List <KeyValuePair <string, Object> >()
{
new KeyValuePair <string, object>("image_file", CreateFileMultipartContent(imageFile, imageFileHeaders))
};
_fields.Add(new KeyValuePair <string, object>("request", CreateJsonEncodedMultipartContent(request, requestHeaders)));
//remove null parameters
_fields = _fields.Where(kvp => kvp.Value != null).ToList();
//prepare the API call request to fetch the response
HttpRequest _request = GetClientInstance().Post(_queryUrl, _headers, _fields);
if (HttpCallBack != null)
{
HttpCallBack.OnBeforeHttpRequestEventHandler(GetClientInstance(), _request);
}
_request = await authManagers["default"].ApplyAsync(_request).ConfigureAwait(false);
//invoke request and get response
HttpStringResponse _response = await GetClientInstance().ExecuteAsStringAsync(_request, cancellationToken).ConfigureAwait(false);
HttpContext _context = new HttpContext(_request, _response);
if (HttpCallBack != null)
{
HttpCallBack.OnAfterHttpResponseEventHandler(GetClientInstance(), _response);
}
//handle errors defined at the API level
base.ValidateResponse(_response, _context);
var _responseModel = ApiHelper.JsonDeserialize <Models.CreateDisputeEvidenceFileResponse>(_response.Body);
_responseModel.Context = _context;
return(_responseModel);
}
/// <summary>
/// Uploads a file to use as evidence in a dispute challenge. The endpoint accepts HTTP.
/// multipart/form-data file uploads in HEIC, HEIF, JPEG, PDF, PNG, and TIFF formats..
/// </summary>
/// <param name="disputeId">Required parameter: The ID of the dispute you want to upload evidence for..</param>
/// <param name="request">Optional parameter: Defines the parameters for a `CreateDisputeEvidenceFile` request..</param>
/// <param name="imageFile">Optional parameter: Example: .</param>
/// <param name="cancellationToken"> cancellationToken. </param>
/// <returns>Returns the Models.CreateDisputeEvidenceFileResponse response from the API call.</returns>
public async Task <Models.CreateDisputeEvidenceFileResponse> CreateDisputeEvidenceFileAsync(
string disputeId,
Models.CreateDisputeEvidenceFileRequest request = null,
FileStreamInfo imageFile = null,
CancellationToken cancellationToken = default)
{
// the base uri for api requests.
string baseUri = this.Config.GetBaseUri();
// prepare query string for API call.
StringBuilder queryBuilder = new StringBuilder(baseUri);
queryBuilder.Append("/v2/disputes/{dispute_id}/evidence-files");
// process optional template parameters.
ApiHelper.AppendUrlWithTemplateParameters(queryBuilder, new Dictionary <string, object>()
{
{ "dispute_id", disputeId },
});
// append request with appropriate headers and parameters
var headers = new Dictionary <string, string>()
{
{ "user-agent", this.UserAgent },
{ "accept", "application/json" },
{ "Square-Version", this.Config.SquareVersion },
};
var requestHeaders = new Dictionary <string, IReadOnlyCollection <string> >(StringComparer.OrdinalIgnoreCase)
{
{ "Content-Type", new[] { "application/json; charset=utf-8" } },
};
var imageFileHeaders = new Dictionary <string, IReadOnlyCollection <string> >(StringComparer.OrdinalIgnoreCase)
{
{ "Content-Type", new[] { string.IsNullOrEmpty(imageFile.ContentType) ? "image/jpeg" : imageFile.ContentType } },
};
// append form/field parameters.
var fields = new List <KeyValuePair <string, object> >()
{
new KeyValuePair <string, object>("image_file", CreateFileMultipartContent(imageFile, imageFileHeaders)),
};
fields.Add(new KeyValuePair <string, object>("request", CreateJsonEncodedMultipartContent(request, requestHeaders)));
// remove null parameters.
fields = fields.Where(kvp => kvp.Value != null).ToList();
// prepare the API call request to fetch the response.
HttpRequest httpRequest = this.GetClientInstance().Post(queryBuilder.ToString(), headers, fields);
if (this.HttpCallBack != null)
{
this.HttpCallBack.OnBeforeHttpRequestEventHandler(this.GetClientInstance(), httpRequest);
}
httpRequest = await this.AuthManagers["global"].ApplyAsync(httpRequest).ConfigureAwait(false);
// invoke request and get response.
HttpStringResponse response = await this.GetClientInstance().ExecuteAsStringAsync(httpRequest, cancellationToken).ConfigureAwait(false);
HttpContext context = new HttpContext(httpRequest, response);
if (this.HttpCallBack != null)
{
this.HttpCallBack.OnAfterHttpResponseEventHandler(this.GetClientInstance(), response);
}
// handle errors defined at the API level.
this.ValidateResponse(response, context);
var responseModel = ApiHelper.JsonDeserialize <Models.CreateDisputeEvidenceFileResponse>(response.Body);
responseModel.Context = context;
return(responseModel);
}