COVID-19: Všechna školení nyní i on-line. Přečtěte si mé tipy na vzdělávání v době koronavirové.
Slovenská verzeSlovensky

Napojte se bleskově na iDoklad se C# SDK

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.

Miroslav Holec

Miroslav Holec

7. dubna. 2016
upraven 6. dubna. 2016

Tento článek je již velmi zastaralý. Zastaralé články nemusí popisovat aktuální stav technologií, nejideálnější řešení a můj aktuální pohled na danou technologii.

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!


👨‍🎓 Webináře pro vývojáře - nyní zdarma

Vzdělávat se můžete i z pohodlí domova. Klasická školení jsem doplnil o související témata, která si můžete poslechnout v podobě živých webinářů. Přidejte se téměř 200 vývojářům, kteří se již připojili k mým webinářům!

Termín Místo
🍀 Software a nástroje, které používám 6. října 2020 online více
🍀 Co ještě nevíte o middlewares 9. října 2020 online více
🍀 Blazor Server 16. října 2020 online více
🍀 Novinky v .NET 5 pro REST API 21. října 2020 online více
Loading