Slovenská verze


Napojte se bleskově na iDoklad se C# SDK

Miroslav Holec

Miroslav Holec

7. dubna. 2016 , aktualizace 6. dubna. 2016

Oblíbený on-line fakturační systém iDoklad má už dlouhou dobu k dispozici RESTful API, díky kterému mohou uživatelé spravovat svou agendu. Pro Cígler Software jsem sestavil open source SDK, které umožňuje se současným API velmi jednoduše komunikovat. Aktuální stabilní verze 1.0.4 má podporu pro .NET >= 4.5 a je dostupná i ve formě NuGet balíčku.

Dostupnost

Současnou verzi iDoklad SDK 1.0.4 je možné nainstalovat jako NuGet package IdokladSdk:

PM> Install-Package IdokladSdk

Pro REST komunikaci je interně použita knihovna RestSharp společně s Newtonsoft.Json. V případě rozšíření SDK je projekt možné pro vlastní potřeby forknout na GitHubu. Knihovna RestSharp bude v dalších verzích dost možná nahrazena vlastní implementací REST klienta.

Použití

Současná verze API vyžaduje pro ověření email a heslo uživatele. Realizace v SDK je řešena pomocí tříd AuthClient a ApiContext.

var authClient = new OAuthClient("your@email.tld", "password");
var apiContext = new ApiContext(authClient.GetSecureToken())
{
    AppName = "Application name",
};

Dále je již možné sestavit vlastní ApiExplorer a dotazovat se na potřebná data. Příkladem budiž vytvoření nového kontaktu z výchozí šablony a jeho odstranění:

var api = new ApiExplorer(apiContext);

// get template for new contact
var template = api.Contacts.Default();

// cast to insert model
var contact = (ContactCreate)template;

// fill new contact
contact.CompanyName = "New Company";

// insert
var addedContact = api.Contacts.Create(contact);

// delete
bool isDeleted = api.Contacts.Delete(addedContact.Id);

Líbí se Vám SDK? Používáte iDoklad a máte nápad jak SDK vylepšit? Napište do diskuse!

TOP Termíny školení

ASP.NET Core se dočkal již své třetí verze a nabízí řadu možností pro vývoj webových aplikací a služeb. I v roce 2020 mám vypsané termíny na nejrůznější témata od základů .NET Core přes vývoj REST API až po mikroslužby pomocí gRPC.

Termín Místo
🍀 Novinky a změny v ASP.NET Core 3.x leden 2020 Praha více
🍀 Vývoj REST API v .NET Core (třídenní) leden 2020 Praha více
🍀 Vývoj aplikací v ASP.NET Core březen 2020 Praha více
🍀 Microservices v ASP.NET Core gRPC březen 2020 Praha více
🍀 Vývoj REST API v .NET Core (dvoudenní) březen 2020 Praha více
🍀 Tipy a triky pro ASP.NET Core březen 2020 Praha více

👨‍🎓 Čerstvá školení 2020
👍 Vývoj aplikací v ASP.NET Core
👍 Vývoj REST služeb v .NET Core
👍 Microservices v ASP.NET Core gRPC
👍 Tipy a triky v ASP.NET Core
👍 Změny v ASP.NET Core 3.x