PHPackages                             malcanek/idoklad - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. malcanek/idoklad

AbandonedArchivedLibrary[API Development](/categories/api)

malcanek/idoklad
================

PHP třída pro ulehčení požadavků na iDoklad api v1.

v1.1(9y ago)046MITPHPPHP >=5.0.0

Since Nov 28Pushed 8y ago1 watchersCompare

[ Source](https://github.com/malcanek/iDoklad)[ Packagist](https://packagist.org/packages/malcanek/idoklad)[ Docs](https://github.com/malcanek/iDoklad)[ RSS](/packages/malcanek-idoklad/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

Tato knihovna již není dále vyvíjena a nebude podporována ani ze strany iDokladu. iDoklad nyní používá api v2, ke kterému můžete naleznout php knihovnu na [malcanek/iDoklad-v2](https://github.com/malcanek/iDoklad-v2)
========================================================================================================================================================================================================================

[](#tato-knihovna-již-není-dále-vyvíjena-a-nebude-podporována-ani-ze-strany-idokladu-idoklad-nyní-používá-api-v2-ke-kterému-můžete-naleznout-php-knihovnu-na-malcanekidoklad-v2)

iDoklad
=======

[](#idoklad)

PHP třída pro ulehčení požadavků na iDoklad api v1.

\#Získání tokenu a následná autorizace požadavků Pro zadání prostředí, které je vyžadováno v hlavičkách iDokladu slouží funkce setEnviroment(XApp, Version, Token). Při získávání tokenu se zavolá bez proměnné token:

```
iDoklad::setEnviroment('Moje aplikace', 1.0);
```

Pokud již známe token, volá se funkce takto:

```
iDoklad::setEnviroment('Moje aplikace', 1.0, 'můj tajný token');
```

Pro získání tokenu slouží funkce getToken(email, heslo). Pokud se nepodaří token získat, nebo nejsou zadané parametry s názvem aplikace a její verzí, vyhodí funkce výjimku (Exception). Ta má ve zprávě buď 'Zadejte nazev aplikace a jeji verzi' (= zavolejte funkci setEnviroment, nebo obsahuje chybu z api (např. špatné jméno a heslo). Pokud proběhne získání úspěšně, uloží token do třídy a zároveň ho vrátí pro další zpracování (např. uložení do db).

```
iDoklad::getToken('muj@email.cz', 'mojetajneheslo');
```

\#Třída iDoklad Tato třída slouží k obsluhování api pomocí funkcí v ní vytvořených. Každá funkce je zdokumentována ohledně proměnných + obsahuje odkaz na dokumentaci api, aby bylo jasné, jaké parametry je třeba zadávat. U funkcí pro získávání PDF je třeba zadat adresu, kam se má PDF uložit.

Může se stát, že některé funkce nebudou fungovat správně, nebo tak jak by měly. Pokud tomu tak bude, můžete mne kontaktovat a pokusím se je opravit.

\#Třída iDokladMini Zjednodušená třída pro přístup k api. Obsahuje pouze funkci na získání tokenu, nastavení prostředí a následné zavolání do api. Volání do api lze provádět na libolné adresy, prefix api není nutné používat. Pro dotaz do api se volá funkce curlData(adresa, parametry GET, hlavička, parametry POST).

Adresa je odkaz do api (např. IssuedInvoices) Parametry GET jsou parametry, které se posílají api (např. filtry). Vkládá se sem celé pole (array). Výchozí hodnota je prázdné pole. Hlavička je hlavička značící typ dotazu, povolené jsou GET (výchozí), POST, PUT, DELETE. Parametry POST jsou parametry určené POST a PUT příkazy. Výchozí hodnota je prázdné pole.

Příklady GET dotazu

```
$data = iDokladMini::curlData('IssuedInvoices');
$data = iDokladMini::curlData('IssuedInvoices', $filter);
```

Příklad POST dotazu

```
$data = iDokladMini::curlData('IssuedInvoices', array(), 'POST', $params);
```

Příklad PUT dotazu

```
$data = iDokladMini::curlData('IssuedInvoices/'.$id, array(), 'PUT', $params);
```

Příkald DELETE dotazu

```
iDokladMini::curlData('IssuedInvoices/'.$id, array(), 'DELETE', array());
```

Třída automaticky nekontroluje zadaný token!

Třída obsahuje funkci na uložení PDF v případě jeho stažení. Tato funkce se volá base64toPDF(pdf, path). Jako první parametr se zadá base64 pdf řetězec. Jako druhý parametr se zadává adresa, kam se má PDF uložit.

iDoklad
=======

[](#idoklad-1)

PHP třída pro ulehčení požadavků na iDoklad api.

\#Získání tokenu a následná autorizace požadavků Pro zadání prostředí, které je vyžadováno v hlavičkách iDokladu slouží funkce setEnviroment(XApp, Version, Token). Při získávání tokenu se zavolá bez proměnné token:

```
iDoklad::setEnviroment('Moje aplikace', 1.0);
```

Pokud již známe token, volá se funkce takto:

```
iDoklad::setEnviroment('Moje aplikace', 1.0, 'můj tajný token');
```

Pro získání tokenu slouží funkce getToken(email, heslo). Pokud se nepodaří token získat, nebo nejsou zadané parametry s názvem aplikace a její verzí, vyhodí funkce výjimku (Exception). Ta má ve zprávě buď 'Zadejte nazev aplikace a jeji verzi' (= zavolejte funkci setEnviroment, nebo obsahuje chybu z api (např. špatné jméno a heslo). Pokud proběhne získání úspěšně, uloží token do třídy a zároveň ho vrátí pro další zpracování (např. uložení do db).

```
iDoklad::getToken('muj@email.cz', 'mojetajneheslo');
```

\#Třída iDoklad Tato třída slouží k obsluhování api pomocí funkcí v ní vytvořených. Každá funkce je zdokumentována ohledně proměnných + obsahuje odkaz na dokumentaci api, aby bylo jasné, jaké parametry je třeba zadávat. U funkcí pro získávání PDF je třeba zadat adresu, kam se má PDF uložit.

Může se stát, že některé funkce nebudou fungovat správně, nebo tak jak by měly. Pokud tomu tak bude, můžete mne kontaktovat a pokusím se je opravit.

\#Třída iDokladMini Zjednodušená třída pro přístup k api. Obsahuje pouze funkci na získání tokenu, nastavení prostředí a následné zavolání do api. Volání do api lze provádět na libolné adresy, prefix api není nutné používat. Pro dotaz do api se volá funkce curlData(adresa, parametry GET, hlavička, parametry POST).

Adresa je odkaz do api (např. IssuedInvoices) Parametry GET jsou parametry, které se posílají api (např. filtry). Vkládá se sem celé pole (array). Výchozí hodnota je prázdné pole. Hlavička je hlavička značící typ dotazu, povolené jsou GET (výchozí), POST, PUT, DELETE. Parametry POST jsou parametry určené POST a PUT příkazy. Výchozí hodnota je prázdné pole.

Příklady GET dotazu

```
$data = iDokladMini::curlData('IssuedInvoices');
$data = iDokladMini::curlData('IssuedInvoices', $filter);
```

Příklad POST dotazu

```
$data = iDokladMini::curlData('IssuedInvoices', array(), 'POST', $params);
```

Příklad PUT dotazu

```
$data = iDokladMini::curlData('IssuedInvoices/'.$id, array(), 'PUT', $params);
```

Příkald DELETE dotazu

```
iDokladMini::curlData('IssuedInvoices/'.$id, array(), 'DELETE', array());
```

Třída automaticky nekontroluje zadaný token!

Třída obsahuje funkci na uložení PDF v případě jeho stažení. Tato funkce se volá base64toPDF(pdf, path). Jako první parametr se zadá base64 pdf řetězec. Jako druhý parametr se zadává adresa, kam se má PDF uložit.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

3450d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/abe201fef46a11b19f05db777227c4f82aeb6638597e3a1e6d6916e1ec6dc043?d=identicon)[malcanek](/maintainers/malcanek)

---

Top Contributors

[![malcanek](https://avatars.githubusercontent.com/u/21026285?v=4)](https://github.com/malcanek "malcanek (3 commits)")

---

Tags

idokladfakturace

### Embed Badge

![Health badge](/badges/malcanek-idoklad/health.svg)

```
[![Health](https://phpackages.com/badges/malcanek-idoklad/health.svg)](https://phpackages.com/packages/malcanek-idoklad)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)