Client Setup

The NexudusApiClient is the central object you use to interact with the Nexudus API. It requires an HttpClient, an authentication provider, and an optional configuration object.

Basic setup

using Nexudus.Sdk;
using Nexudus.Sdk.Auth;
using Nexudus.Sdk.Configuration;

var auth = new BasicAuthProvider("[email protected]", "password");

using var client = new NexudusApiClient(new HttpClient(), auth);

Configuration options

Pass a NexudusOptions object to customise the client behaviour:

var options = new NexudusOptions
{
    BaseUrl = "https://spaces.nexudus.com", // Default
    PageSize = 25,                          // Default page size for listings
    Timeout = TimeSpan.FromSeconds(30)      // HTTP request timeout
};

using var client = new NexudusApiClient(new HttpClient(), auth, options);

Option	Type	Default	Description
`BaseUrl`	`string`	`https://spaces.nexudus.com`	The Nexudus API base URL.
`PageSize`	`int`	`25`	Default number of records per page.
`Timeout`	`TimeSpan`	`30 seconds`	HTTP request timeout.

Using environment variables

For scripts and CI/CD pipelines, store credentials in environment variables instead of hard-coding them:

var email = Environment.GetEnvironmentVariable("NEXUDUS_EMAIL")
    ?? throw new InvalidOperationException("NEXUDUS_EMAIL not set");
var password = Environment.GetEnvironmentVariable("NEXUDUS_PASSWORD")
    ?? throw new InvalidOperationException("NEXUDUS_PASSWORD not set");

var auth = new BasicAuthProvider(email, password);
using var client = new NexudusApiClient(new HttpClient(), auth);

Set the variables before running your app:

PowerShell
Bash

$env:NEXUDUS_EMAIL = "[email protected]"
$env:NEXUDUS_PASSWORD = "your-password"

export NEXUDUS_EMAIL="[email protected]"
export NEXUDUS_PASSWORD="your-password"

Never commit credentials to source control. Use environment variables, user secrets, or a vault for production deployments.

Entity endpoints

Once you have a client, create endpoint instances for the entities you need:

var coworkers  = new CoworkerEndpoint(client);
var bookings   = new BookingEndpoint(client);
var products   = new ProductEndpoint(client);
var businesses = new BusinessEndpoint(client);

There are 200+ endpoint classes available — one for every entity type in the Nexudus API. They all expose the same set of methods described in the following pages.

Getting Started

Working with Data

Advanced

Client Setup

Client Setup

Basic setup

Configuration options

Using environment variables

Entity endpoints

​Client Setup

​Basic setup

​Configuration options

​Using environment variables

​Entity endpoints

Client Setup

Basic setup

Configuration options

Using environment variables

Entity endpoints