Napojte se bleskově na iDoklad se C# SDK

Miroslav Holec

Miroslav Holec

Publikován 7. dubna 2016 | Devtips

Tento článek je starší 18 měsíců a je proto možné, že popisuje postupy nebo technologie, které v uplynulé době mohly doznat výraznějších změn. Názory a myšlenky v tomto článku již nemusí vyjadřovat současné stanovisko autora nebo autorů. Článek byl napsán 7. 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.

.NET Core

Nová podzimní školení .NET Core a Entity Framework Core

Chcete se dozvědět o novinkách v moderním vývojářském stacku (ASP).NET Core a Entity Framework Core? Připravil jsem krátká úderná školení, ve kterých se zaměřím na nové aspekty těchto technologií. Žádná omáčka a žádné opáčko toho, co už znáte. Prostě jen to nové.

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!

Zeptejte se


Školení webového vývoje

Krátká a úderná školení zaměřená na skutečné novinky ve světě webového vývoje.

DatumNázev školeníMístoDélkaCenaStav
08.10.2018Infrastruktura ASP.NET CorePraha3 h.1 500 KčVolná místana registraci ⇒
08.10.2018Úvod do Entity Framework CorePraha4 h.1 900 KčVolná místana registraci ⇒
09.10.2018RESTful Web API s ASP.NET Core MVCPraha3 h.1 500 KčVolná místana registraci ⇒
09.10.2018Diagnostika aplikací s App insightsPraha4 h.1 900 KčVolná místana registraci ⇒

HOLEC, Miroslav. Napojte se bleskově na iDoklad se C# SDK. Azure & ASP.NET Core Blog [online]. Praha: Miroslav Holec, ©2010-2016. Poslední změna článku 6.4.2016 [vid. 2018-09-19]. Dostupné z: https://www.miroslavholec.cz/blog/napojte-se-bleskove-na-idoklad-se-c-sdk