Doppler.SDK 0.1.0-preview.1

Doppler.SDK

Doppler.SDK is an idiomatic C# preview SDK for the Doppler API. It targets netstandard2.0, uses HttpClient, and mirrors the public service/method surface of Doppler's Node SDK.

Install

dotnet add package Doppler.SDK --version 0.1.0-preview

Get a Doppler Token

For applications that only need to read secrets from one project/config, create a Doppler Service Token:

1. Open the Doppler dashboard.
2. Go to the project and select the config your app should read from.
3. Open the Access tab.
4. Click Generate.
5. Name the token, optionally set expiration or write access, then click Generate Service Token.
6. Copy the token immediately. Doppler only shows it once.

You can also create one with the Doppler CLI:

doppler configs tokens create --project your-project --config your-config token-name --plain

Use that token as the SDK access token:

using var doppler = new DopplerClient(Environment.GetEnvironmentVariable("DOPPLER_TOKEN"));

Service Tokens are the recommended production default for secret reads because they are scoped to a single config. For broader API management workflows, such as creating projects, managing users, or calling workplace-level endpoints, use a Doppler Service Account API Token or another token with the required permissions.

Quickstart

using Doppler;

using var doppler = new DopplerClient("dp.xx.yyy");

var projects = await doppler.Projects.ListAsync(new DopplerRequestParameters
{
    ["page"] = 1,
    ["perPage"] = 20
});

Console.WriteLine(projects);

Configuration

Inject your own HttpClient when you manage connection lifetime elsewhere:

var httpClient = new HttpClient();
using var doppler = new DopplerClient("dp.xx.yyy", httpClient);

Override the API host for testing:

doppler.SetBaseUrl("https://api.doppler.com");

Update the token after construction:

doppler.SetAccessToken("dp.xx.yyy");

Secrets

var secrets = await doppler.Secrets.DownloadAsync(
    project: "backend",
    configName: "prd",
    optionalParams: new DopplerRequestParameters
    {
        ["format"] = "json",
        ["includeDynamicSecrets"] = true
    });

Error Handling

try
{
    await doppler.Projects.GetAsync("backend");
}
catch (DopplerApiException ex)
{
    Console.Error.WriteLine($"{(int)ex.StatusCode}: {ex.Message}");
    Console.Error.WriteLine(ex.ResponseBody);
}

Service Parity

The service surface is generated from DopplerHQ/node-sdk and audited in docs/service-parity.md. Responses are returned as JsonElement in this preview so the SDK can expose the full API before typed model generation is finalized.

Development

This repository uses the x64 .NET SDK through its absolute path on this machine:

& 'C:\Program Files\dotnet\dotnet.exe' restore
& 'C:\Program Files\dotnet\dotnet.exe' build
& 'C:\Program Files\dotnet\dotnet.exe' test
& 'C:\Program Files\dotnet\dotnet.exe' pack src\Doppler.SDK\Doppler.SDK.csproj

Optional live checks should be gated by environment variables:

$env:DOPPLER_ACCESS_TOKEN = 'dp.xx.yyy'
$env:DOPPLER_PROJECT = 'backend'
$env:DOPPLER_CONFIG = 'dev'
& 'C:\Program Files\dotnet\dotnet.exe' run --project examples\Doppler.SDK.Examples