Frends.HTTP.Request / 1.13.0

Summary

Sends an HTTP request with a text or JSON body and returns status, headers and body. The general-purpose Task for any HTTP API, and the fallback whenever no dedicated Frends Task exists.

Typical use — REST and webhook calls of every kind; the bytes variants are for payloads that must not be treated as text

Details

Frends version: 5.7 and newer
Agent: Crossplatform
Target framework: net8.0

1.13.02026-08-17

Added

Added ThrowErrorOnFailure and ErrorMessageOnFailure options to control error handling: when ThrowErrorOnFailure is set to false, the task returns a Result with Success = false and an Error object instead of throwing an exception.
The Result type now includes Success and Error properties to indicate task outcome.

1.12.02026-06-12

Fixed

Fixed an issue related to concurrency problem with static fields.

1.11.02026-05-07

Added

Added use proxy, proxy URL, username, and password options for configuring HTTP requests through a proxy, and included those settings in the HttpClient cache key.

1.10.02026-05-05

Added

Added SslProtocolVersion option to control the TLS version used for secure connections. Supported values: Default (OS decides, preserves previous behavior), Tls12, Tls13, Tls12And13.
Added HttpProtocolVersion option to control the HTTP protocol version used for requests. Supported values: Http11 (default, preserves previous behavior), Http20 (requires server-side HTTP/2 support via ALPN; no fallback to HTTP/1.1).

1.9.02026-04-15

Fixed

Fixed an issue where selecting JToken as the return format would throw an exception if the server returned a non-JSON response; the response body is now returned as a raw string instead, preserving the status code for flow control.

1.8.02026-03-07

Fixed

Improve the handling of disposable objects to avoid problems with timeouts related to HttpClient.

Added

Added an option "CacheHttpClient" to disable caching httpClient. (there were cached by default)

1.7.02026-03-03

Added

Added CertificateStoreLocation option to allow selection between CurrentUser and LocalMachine certificate stores when using certificate authentication.

1.6.02026-01-27

Fixed

GET requests ignore message body content

1.5.02025-10-03

Changed

Changed default return format from String to JToken

1.4.02025-03-25

Changed

Update packages: Newtonsoft.Json 12.0.1 -> 13.0.3 System.DirectoryServices 7.0.0 -> 9.0.3 System.Runtime.Caching 7.0.0 -> 9.0.3 coverlet.collector 3.1.0 -> 6.0.4 Microsoft.NET.Test.Sdk 16.7.0 -> 17.13.0 MSTest.TestAdapter 2.1.2 -> 3.8.3 MSTest.TestFramework 2.1.2 -> 3.8.3 nunit 3.12.0 -> 4.3.2 NUnit3TestAdapter 3.17.0 -> 5.0.0 RichardSzalay.MockHttp 6.0.0 -> 7.0.0 xunit.extensibility.core 2.4.2 -> 2.9.3

1.3.02024-12-30

Changed

Descriptions of ClientCertificate suboptions includes clearer information about usage in terms of different types of ClientCertificate.

1.2.02024-08-19

Changed

Removed handling where only PATCH, PUT, POST and DELETE requests were allowed to have the Content-Type header and content, due to HttpClient failing if e.g., a GET request had content. HttpClient has since been updated to tolerate such requests.

1.1.22024-01-16

Fixed

Fixed misleading documentation.

1.1.12023-06-09

Fixed

Fixed issue with terminating the Task by adding cancellationToken to the method ReadAsStringAsync when JToken as ReturnFormat.

1.1.02023-05-08

Changed

Breaking Changed ResultMethod to ReturnFormat which describes the parameter better.
Fixed documentation link in the main method.

1.0.02023-01-24

Added

Initial implementation of Frends.HTTP.Request.