RESTSchemaRetry is a .NET library that implements a simple Schema-Retry pattern in REST API context to enhance application resilience. A Schema-Retry handles transient failures when attempting to connect to a service or network resource by transparently retrying failed operations.
RESTSchemaRetry implements a straightforward retry mechanism with a delay, managing communication timeouts or service errors transparently to the application. The retry mechanism checks the HTTP response code to determine whether the error is transient or not.
Below is the list of potentially transient errors handled by RESTSchemaRetry:
- TooManyRequests
- InternalServerError
- BadGateway
- ServiceUnavailable
- GatewayTimeout
- InsufficientStorage
- RequestTimeout
- HttpVersionNotSupported
- NetworkAuthenticationRequired
To use the RESTSchemaRetry library, just instantiate a RetryClient object specifying the base URL and the resource. There are multiple constructor to specify the REST API parameters.
var retryClient = new RetryClient("https://example.com/","resource");
at this point the REST API requests can be performed. For example, below how to execute a POST request:
var response = retryClient.Post<T>(objectToPost);
RESTSchemaRetry uses the RestSharp library to execute the web requests.
The library is available on NuGet packetmanager. https://www.nuget.org/packages/RESTSchemaRetry/
RESTSchemaRetry uses the RestSharp library, which is distributed under Apache 2.0 license.
Thank you for considering to help out with the source code! If you'd like to contribute, please fork, fix, commit and send a pull request for the maintainers to review and merge into the main code base.
- Setting up Git
- Fork the repository
- Open an issue if you encounter a bug or have a suggestion for improvements/features
RESTSchemaRetry source code is available under MIT License, see license in the source.
Please contact at francesco.delre.87[at]protonmail.com for any details.