Textkernel.Tx.SDK 4.0.0

tx-dotnet

The official C# SDK for the Textkernel Tx v10 API for resume/CV and job parsing, searching, and matching. Supports .NET Framework 4.6.1+ and .NET Core 2.0+.

Installation

From within Visual Studio:

1. Open the Solution Explorer.
2. Right-click on a project within your solution.
3. Click on Manage NuGet Packages...
4. Click on the Browse tab and search for "Textkernel.Tx.SDK" (ensure the Package source dropdown is set to nuget.org).
5. Click on the Textkernel.Tx.SDK package, select the appropriate version in the right-tab and click Install.

Using the .NET Core command-line interface (CLI) tools:

dotnet add package Textkernel.Tx.SDK

Using the NuGet Command Line Interface (CLI):

nuget install Textkernel.Tx.SDK

Using the Package Manager Console:

Install-Package Textkernel.Tx.SDK

Documentation

To view MSDN-style documentation for this SDK, check out our DocFX-generated docs. For the full REST API documentation, information about best practices, FAQs, etc. check out our API docs.

Examples

For full code examples, see here.

Basic Usage

Creating a TxClient

This is the object that you will use to perform API calls. You create it with your account credentials and the TxClient makes the raw API calls for you. These credentials can be found in the Tx Console. Be sure to select the correct DataCenter for your account.

Without using dependency injection:

TxClient client = new TxClient(httpClient, new TxClientSettings
{
    AccountId = "12345678",
    ServiceKey = "abcdefghijklmnopqrstuvwxyz",
    DataCenter = DataCenter.US
});

Note that the TxClient uses HttpClient and you should follow Microsoft's recommendations here.

Using dependency injection:

Install the Microsoft.Extensions.Http package from nuget. Where you register your services, add the following code:

builder.Services.AddSingleton(_ => new TxClientSettings
{
    AccountId = "12345678",
    ServiceKey = "abcdefghijklmnopqrstuvwxyz",
    DataCenter = DataCenter.US
};
builder.Services.AddHttpClient<ITxClient, TxClient>();

After injecting your TxClient, you will be able to get it from the service provider:

ITxClient client = serviceProvider.GetRequiredService<ITxClient>();

For self-hosted customers, you can create a DataCenter object with your custom URL using the constructor provided on that class.

Using the various TxClient services

The TxClient has the following services available, exposed as properties on the ITxClient interface:

• Parser
• Geocoder
• Formatter
• SkillsIntelligence
• SearchMatchV1
• SearchMatchV2

Each service exposes certain API functionality via its methods. For example, to parse a resume you would do something like:

ITxClient client;//created or injected however
var parseResponse = await client.Parser.ParseResume(...);

For the complete list of methods on each service and their method signatures, check out our DocFX-generated docs.

Handling errors and the TxException

Every call to any of the methods in the TxClient should be wrapped in a try/catch block. Any 4xx/5xx level errors will cause a TxException to be thrown. Sometimes these are a normal and expected part of the Tx API. For example, if you have a website where users upload resumes, sometimes a user will upload a scanned image as their resume. Textkernel does not process these, and will return a 422 Unprocessable Entity response which will throw a TxException. You should handle any TxException in a way that makes sense in your application.

Additionally, there are TxUsableResumeException and TxUsableJobException which are thrown when some error/issue occurs in the API, but the response still contains a usable resume/job. For example, if you are geocoding while parsing and there is a geocoding error (which happens after parsing is done), the ParsedResume might still be usable in your application.