Dime.Scheduler.Sdk 2.0.0-alpha.3

Dime.Scheduler SDK for .NET

This repository contains the .NET SDK for Dime.Scheduler's RESTful API services. The SDK is a gateway to connect any system to Dime.Scheduler through its extensive import pipeline and large collection of web APIs.

Check out the 📚 docs » for more info.

Installation

Use the package manager NuGet to install the base library of the SDK:

dotnet add package Dime.Scheduler.Sdk

Prerequisites

To clone and run this application, you'll need Visual Studio 2022 or higher. The application is built with C# 10 and targets:

• .NET 7
• .NET 8

Version 2 is built for the cloud version of Dime.Scheduler. Use 1.x.x for on-premise versions.

Usage

The example below fetches the resources available in Dime.Scheduler:

DimeSchedulerClient client = new("http://mydimescheduler.com", "my-api-key");
IEnumerable<Resource> resources = await client.Resources.GetAsync(new ResourceRequest());
foreach (Resource resource in resources)
    Console.WriteLine(resource.Email);

The DimeSchedulerClient class is the entry point and it is where all endpoints are exposed:

DimeSchedulerClient client = new(uri,  "my-api-key");

Two arguments are required: the URI to Dime.Scheduler and a valid API key. With these credentials, you can access any of the endpoints.

IEnumerable<Resource> resources = await resourceEndpoint.GetAsync(new ResourceRequest());

Import

The import API is the entry point for external systems to feed data into Dime.Scheduler. The import endpoints expose a set of import pipelines to map and save data in the Dime.Scheduler database. Any class that implements the IImportRequestable interface is eligible to be processed by the import service in Dime.Scheduler.

This example adds or updates a category:

using Dime.Scheduler.Sdk.Import;

DimeSchedulerClient client = new(uri,  "my-api-key");
Category category = new("Category #1", "#6e62b5");
await client.Import.RunAsync(category, TransactionType.Append);

This example adds or updates a filter group:

using Dime.Scheduler.Sdk.Import;

string uri = "http://mydimescheduler.com";
DimeSchedulerClient client = new(uri,  "my-api-key");

FilterGroup filterGroup = new FilterGroup { Name = "Group 1" };
await client.Import.RunAsync(filterGroup, TransactionType.Append);

Read more

Check out the 📚 docs » for more info.