Inlet.Client (2026.10.0)

Published 2026-10-14 20:49:11 +00:00 by ferociousbyte

Installation

dotnet nuget add source --name talaryonlabs --username your_username --password your_token 
dotnet add package --source talaryonlabs --version 2026.10.0 Inlet.Client

About this package

Sends the contact form of a website to inlet, from the website's server: with an Idempotency-Key, a timeout and retries.

Inlet.Client

Sends the contact form of a website to inlet, the contact tool of the optiwi platform. It runs on the website's server: the key of the site never reaches the browser.

builder.Services.AddInletClient(options =>
{
    options.Url = "https://inlet.optiwi.solutions";
    options.SiteKey = "inl_live_...";   // from your configuration, not from the code
});
@inject InletClient Inlet

var result = await Inlet.SubmitAsync(new Submission
{
    Name = form.Name,
    Email = form.Email,
    Phone = form.Phone,
    Subject = form.Topic,
    Message = form.Message,
    Extra = new Dictionary<string, object> { ["company"] = form.Company },
    SourceUrl = Navigation.Uri,
    ClientIp = visitorIp,          // for the rate limit; not stored
    Honeypot = form.Website        // a hidden field people leave empty
});
result.Outcome What to show
Sent Thanks. Also when inlet took it for spam, which looks the same on purpose.
Invalid The fields in result.Errors (name, email, phone, subject, message, extra, ...) at the form.
Failed An error with another way to get in touch, e.g. your e-mail address. The reason is logged.

IsEnabled is false without Url and SiteKey (or with Enabled = false); the form should then offer another way to get in touch, too.

Every submission gets an Idempotency-Key, so a retry is never stored twice. Each attempt waits at most Timeout (10 s); a network error, a timeout, 429 or 5xx is retried after RetryDelays (1 s, 4 s, 10 s). The visitor's IP address has to come from the request of the page; behind a proxy, from X-Forwarded-For (UseForwardedHeaders).

Dependencies

ID Version Target Framework
Microsoft.Extensions.Http 10.0.13 net10.0
Details
NuGet
2026-10-14 20:49:11 +00:00
3
Talaryon Labs
18 KiB
Assets (2)
Versions (4) View all