Noxdren 0.1.2

Noxdren .NET SDK

Official .NET client for the Noxdren API — battery-aware drone range (RangeIQ) and multi-leg mission analysis (RangeIQ+). .NET 8+.

dotnet add package Noxdren

Quickstart

using Noxdren;

using var client = new NoxdrenClient("ndx_...");   // your key from app.noxdren.com

// 1. Available drones
var drones = await client.Drones.ListAsync();
foreach (var d in drones.List("drones"))
    Console.WriteLine(d.Str("key"));

// 2. Range rings around a launch point
var r = await client.RangeIq.AnalyzeAsync(new RangeIqRequest
{
    UserLat = 37.5,
    UserLon = -122.3,
    SelectedDroneKey = "dji_mavic_3",
    WindSpeed = 6.0,
    WindDirection = 270,
});
foreach (var ring in r.Obj("result")!.List("rings"))
    Console.WriteLine($"{ring.Str("label")} @ {ring.Num("battery_threshold_pct")}%");

// 3. Multi-leg mission from waypoints
var m = await client.Missions.AnalyzeGeometryAsync(new MissionRequest
{
    HomeLat = 37.5,
    HomeLon = -122.3,
    DroneKey = "dji_mavic_3",
    Waypoints = new List<Waypoint>
    {
        new() { Lat = 37.50, Lon = -122.30, AltitudeM = 80 },
        new() { Lat = 37.51, Lon = -122.29, AltitudeM = 80, HoverTimeS = 10 },
        new() { Lat = 37.52, Lon = -122.31, AltitudeM = 100 },
    },
    Weather = new Weather { WindSpeedMps = 6.0, WindDirDeg = 270 },
});
Console.WriteLine(m.Obj("result")!.Str("mission_verdict"));  // complete | marginal | cannot_complete

Read responses with typed navigation: r.Obj("result")!.List("rings")[0].Str("label"), or r.Raw for the parsed dictionary.

Authentication

Your API key is sent as the X-API-Key header on every request:

using var client = new NoxdrenClient("ndx_...");

Error handling

Every failure is a typed exception:

try
{
    await client.RangeIq.AnalyzeAsync(req);
}
catch (AuthenticationException) { /* 401 */ }
catch (ValidationException e) { Console.WriteLine($"{e.Code} {e.Message}"); /* 400/422 */ }
catch (RateLimitException e) { Console.WriteLine($"retry after {e.RetryAfter}s"); /* 429 */ }
catch (NoxdrenException e) { Console.WriteLine($"{e.Code} {e.RequestId}"); /* catch-all */ }

Transient errors (429, 5xx, network) are retried automatically with backoff that respects Retry-After. Tune via the maxRetries constructor argument.

Configuration

new NoxdrenClient(
    apiKey: "ndx_...",
    baseUrl: "https://api.noxdren.com",   // override for testing
    timeoutSeconds: 30,
    maxRetries: 2);

What's covered

Full field reference: https://docs.noxdren.com · live schema: https://api.noxdren.com/openapi.json.