Soenneker.N8n.HttpClients
11.0.199
Prefix Reserved
dotnet add package Soenneker.N8n.HttpClients --version 11.0.199
NuGet\Install-Package Soenneker.N8n.HttpClients -Version 11.0.199
<PackageReference Include="Soenneker.N8n.HttpClients" Version="11.0.199" />
<PackageVersion Include="Soenneker.N8n.HttpClients" Version="11.0.199" />
<PackageReference Include="Soenneker.N8n.HttpClients" />
paket add Soenneker.N8n.HttpClients --version 11.0.199
#r "nuget: Soenneker.N8n.HttpClients, 11.0.199"
#:package Soenneker.N8n.HttpClients@11.0.199
#addin nuget:?package=Soenneker.N8n.HttpClients&version=11.0.199
#tool nuget:?package=Soenneker.N8n.HttpClients&version=11.0.199
Soenneker.N8n.HttpClients
Provides cached, API-key-authenticated HttpClient instances for one or more n8n servers.
Installation
dotnet add package Soenneker.N8n.HttpClients
Configuration
{
"N8n": {
"ApiKey": "your-api-key",
"ClientBaseUrl": "https://n8n.example.com/api/v1"
}
}
Usage
using Soenneker.N8n.HttpClients.Abstract;
using Soenneker.N8n.HttpClients.Registrars;
services.AddN8nOpenApiHttpClientAsSingleton();
IN8nOpenApiHttpClient n8n = serviceProvider
.GetRequiredService<IN8nOpenApiHttpClient>();
HttpClient client = await n8n.Get(cancellationToken);
Use Get(apiKey, baseUrl) to connect to another n8n server. Equivalent connection settings reuse the same client within the provider's lifetime.
The default authentication header is X-N8N-API-KEY: {token}. N8n:AuthHeaderName and N8n:AuthHeaderValueTemplate can override it for a compatible gateway.
Do not dispose a returned HttpClient; the registered provider owns it and removes it from the cache when disposed.
Network access policy
By default, clients use ISsrfHttpClientCache: DNS is resolved and checked when
opening each socket, and the connection uses those validated addresses. Private,
loopback, and reserved addresses are blocked.
Applications that intentionally connect to private/self-hosted n8n instances can opt in through trusted application configuration:
{
"N8n": {
"AllowPrivateNetworkAccess": true
}
}
This selects ordinary IHttpClientCache for that provider. Omit the setting or
set it to false for public-only access. The policy is read when the provider is
constructed and applies to every connection it creates; do not populate it from
user-supplied connection data. Enabling it permits all destinations, not just a
particular private host.
Automatic redirects remain disabled in both modes so the API-key header cannot be forwarded by a redirect. Configure the final n8n base URL directly.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net11.0 is compatible. |
-
net11.0
- Soenneker.Extensions.Configuration (>= 11.0.917)
- Soenneker.Hashing.XxHash (>= 11.0.135)
- Soenneker.Utils.HttpClientCache.Ssrf (>= 11.0.111)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Soenneker.N8n.HttpClients:
| Package | Downloads |
|---|---|
|
Soenneker.N8n.OpenApiClientUtil
Creates and caches authenticated n8n API clients for one or more servers. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 11.0.199 | 73 | 11/11/2026 |
| 11.0.198 | 63 | 11/11/2026 |
| 11.0.197 | 66 | 11/11/2026 |
| 11.0.196 | 77 | 11/11/2026 |
| 4.0.184 | 492 | 10/26/2026 |
| 4.0.183 | 226 | 10/15/2026 |
| 4.0.182 | 121 | 10/15/2026 |
| 4.0.181 | 117 | 10/14/2026 |
| 4.0.179 | 118 | 10/14/2026 |
| 4.0.178 | 116 | 10/14/2026 |
| 4.0.177 | 117 | 10/14/2026 |
| 4.0.171 | 115 | 10/13/2026 |
| 4.0.170 | 122 | 10/13/2026 |
| 4.0.166 | 114 | 10/12/2026 |
| 4.0.165 | 104 | 10/12/2026 |
| 4.0.163 | 106 | 10/11/2026 |
| 4.0.162 | 105 | 10/11/2026 |
| 4.0.161 | 101 | 10/11/2026 |
| 4.0.160 | 183 | 10/9/2026 |
| 4.0.159 | 205 | 10/1/2026 |
Updated Multiple NuGet packages