Finturest.Email.Abstractions 1.0.1

Finturest Email API C# SDK

Official C# SDK for the Finturest Email API - supports .NET Standard 2.0+ and all modern .NET versions.

Overview

This SDK provides a simple and reliable way to integrate Finturest Email API functionality into your .NET applications. It supports .NET Standard 2.0 and later, ensuring compatibility with .NET Core and the latest .NET releases.

Features

• Accurate Format Validation: Ensures email addresses are correctly structured according to RFC standards before processing.

• Domain Reliability Checks: Verifies that email domains are properly configured with MX records to improve deliverability and reduce bounce rates.

• Disposable and Free Email Detection: Identifies temporary and free email providers to help prevent fraud, spam, fake accounts, and low-quality signups.

• Role-Based Email Filtering: Flags generic role-based addresses like info@, support@, etc., to improve user targeting and communication quality.

Installation

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

dotnet add package Finturest.Email

Using the NuGet Command Line Interface (CLI):

nuget install Finturest.Email

Using the Package Manager Console:

Install-Package Finturest.Email

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 "Finturest.Email".
5. Click on the Finturest.Email package, select the appropriate version in the right-tab and click Install.

Usage

Registering

To use the Finturest.Email client, register it in your application's dependency injection container using AddFinturestEmail. This configures the services required to communicate with the Finturest Email API.

var services = new ServiceCollection();

services.AddFinturestEmail(options =>
{
    options.ApiKey = "YOUR_API_KEY";
});

Note
IEmailServiceClient is registered in the DI container and should be resolved via dependency injection.
In ASP.NET Core applications, it's recommended to inject it through constructor injection.

Note
The abstractions for the Finturest Email API client are provided in a separate package named Finturest.Email.Abstractions.
You can reference this package in your business layer to avoid a tight dependency on the implementation.
Only the root application or composition root should reference the full Finturest.Email package that contains the implementation.

Validating

To validate an email address using the Finturest Email API, create a ValidateEmailRequest and call the ValidateEmailAsync method on the IEmailServiceClient.

var serviceProvider = services.BuildServiceProvider();

var emailServiceClient = serviceProvider.GetRequiredService<IEmailServiceClient>();

var request = new ValidateEmailRequest
{
    Email = "support@finturest.com"
};

var result = await emailServiceClient.ValidateEmailAsync(request);

Console.WriteLine($"Deliverable: {result.Deliverable}.");

Note
In production applications, avoid using BuildServiceProvider() manually.
Instead, use constructor injection to get IEmailServiceClient from the framework’s dependency injection system.

Subscription & Pricing

To get access to the Finturest Email API or subscribe to a plan, please visit the subscription page. An active subscription is required to access the API in production.

Manage subscriptions

API Key Generation

An API key is required to use the SDK and can be generated on your Finturest dashboard:

Generate API key

Documentation

For full API reference and usage guides, please visit the official Finturest Email API documentation:

View API reference

Contact

For support, questions, or inquiries, please contact us at: support@finturest.com