Package Description
$ dotnet add package Merge.ClientThe official Merge C# library, supporting .NET Standard, .NET Core, and .NET Framework.
API reference documentation is available here.
Using the .NET Core command-line interface (CLI) tools:
dotnet add package Merge.Client
Using the NuGet Command Line Interface (CLI):
nuget install Merge.Client
Instantiate the SDK using the MergeClient class. Note that all
of the SDK methods are awaitable!
using Merge;
using Merge.Ats;
Merge merge = new Merge(
"YOUR_API_KEY", "YOUR_ACCOUNT_TOKEN"
)
This SDK contains the ATS, HRIS, CRM, Ticketing, Accounting, and File Storage categories. Even if you do not plan on using more than one Merge API category right now, the SDK provides upgrade-flexibility in case you find new Merge API categories useful in the future.
Each category is namespaced:
Merge merge = new Merge(
"YOUR_API_KEY", "YOUR_ACCOUNT_TOKEN"
)
merge.ATS. # APIs specific to the ATS Category
merge.HRIS. # APIs specific to the HRIS Category
You can override the HttpClient by passing in ClientOptions.
merge = new Merge("YOUR_API_KEY", "YOUR_ACCOUNT_ID", new ClientOptions{
HttpClient = ... // Override the Http Client
BaseURL = ... // Override the Base URL
})
When the API returns a non-zero status code, (4xx or 5xx response), a subclass of MergeException will be thrown:
using Merge;
try {
merge.Ats.Candidates.Retrieve(...);
} catch (MergeException e) {
System.Console.WriteLine(e.Message)
System.Console.WriteLine(e.StatusCode)
}
Below are code snippets of how you can use the C# SDK.
using Merge;
using Merge.Ats;
Merge merge = new Merge("YOUR_API_KEY", "YOUR_ACCOUNT_TOKEN")
merge.Ats.LinkToken.Create(new EndUserDetailsRequest{
EndUserEmailAddress = "john.smith@gmail.com",
EndUserOrganizationName = "acme",
EndUserOriginId = "1234",
})
using Merge;
using Merge.Hris;
MergeClient merge = new Merge(
"YOUR_API_KEY", "YOUR_ACCOUNT_ID"
)
Employee employee = merge.Hris.Employees.RetrieveAsync("0958cbc6-6040-430a-848e-aafacbadf4ae",
new EmployeesRetrieveRequest{
IncludeRemoteData = true
}
);429 Rate Limit, and >=500 Internal errors will all be retried twice with exponential backoff. You can override this behavior globally or per-request.
var merge = new Merge("...", new ClientOptions{
MaxRetries = 1 // Only retry once
});The SDK defaults to a 60s timeout. You can override this behaviour globally or per-request.
var merge = new Merge("...", new ClientOptions{
TimeoutInSeconds = 20 // Lower timeout
});While we value open-source contributions to this SDK, this library is generated programmatically. Additions made directly to this library would have to be moved over to our generation code, otherwise they would be overwritten upon the next generated release. Feel free to open a PR as a proof of concept, but know that we will not be able to merge it as-is. We suggest opening an issue first to discuss with us!
On the other hand, contributions to the README are always very welcome!