PHPackages                             listonoska/api - 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. listonoska/api

ActiveLibrary[API Development](/categories/api)

listonoska/api
==============

API for listonoska.cz

1.1.5(4y ago)51331New BSDPHP

Since Oct 27Pushed 4y ago1 watchersCompare

[ Source](https://github.com/listonoska/API)[ Packagist](https://packagist.org/packages/listonoska/api)[ Docs](https://www.listonoska.cz)[ RSS](/packages/listonoska-api/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (8)Used By (0)

\#Listonoska/API

[![Latest stable](https://camo.githubusercontent.com/155d36050fe90aa33c6151fdc4a265c149e869aea2c1d28a00e808f2b04e106b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6973746f6e6f736b612f4150492e737667)](https://packagist.org/packages/Listonoska/API)

\##Instalace

Nejlepší cesta k instalaci je použitím Composeru [Composer](http://getcomposer.org/):

```
$ composer require listonoska/API
```

\##Použití

ukázky použití naleznete ve složce Examples

\###nejprve je potřeba si získat token:

```
$token = new \Listonoska\API\Token('client_id', 'secret');
$token->getToken(); // vrátí token
```

\###potom si můžeme získat číselníky:

```
$listOfValues = new Listonoska\API\ListsOfValues($token);
$listOfValues->getDeliveryTypes(); // číselník typů dodání
$listOfValues->getPrintTypes(); // číselník typů tisku
$listOfValues->getIsoCodes(); // číselník iso kódů
```

\###když už vše víme, tak můžeme odeslat dopis:

```
$data = array(
    'letterName' => 'test',
    'deliveryType' => 169,
    'printType' => 0,
    'senderCompany' => 'firma',
    'senderPerson' => 'Jan Novák',
    'senderStreet' => 'Palackého',
    'senderHouseNumber' => 15,
    'senderOrientationNumber' => 5,
    'senderCity' => 'Praha',
    'senderZip' => '110 00',
    'addresse' => array(
	array( // první adresát
	    'person' => 'Radek Novák',
	    'street' => 'Lebedova',
	    'city' => 'Praha',
	    'zip' => '110 00',
        ),
	array( // druhý adresát
	    'person' => 'Radek Novotný',
	    'street' => '17.listopadu',
	    'city' => 'Praha',
	    'zip' => '110 00',
        ),
    ),
    'pdf1' => new CurlFile( realpath(__DIR__ . '/example.pdf')) // pdf soubor
);

$letter = new Listonoska\API\Letter($token);
$response = $letter->sendLetter($data); // odešleme dopis, vrátí se nám info o odeslaném dopisu
```

U dopisu toho můžeme posílat více. Co vše lze odeslat naleznete v [dokumentaci](http://docs.listonoska.apiary.io/#reference/prace-s-dopisem/odeslani-dopisu/odeslani-dopisu).

\###Ještě můžeme získat podací lístek u doporučených dopisů (podací lístek nemusí být hned dostupný od vašeho podání)

```
$letter = new Listonoska\API\Letter($token);
$response = $letter->getPostalReceipt($letterId); // id dopisu získáme z odpovědi po odeslání dopisu
```

\###Dopis můžeme stronovat Pokud je potřeba nějaký dopis zrušit, je možné jej stornovat. Stornovat lze do doby, než bude vyřízen českou poštou.

```
$letter = new Listonoska\API\ListsOfValues($token);
$response = $letter->cancelLetter($letterId);
```

V případě úspěchu se vrací **$response->cancelled = 1**

V případě neúspěchu se vrací chybové stavy:

```
$response->status; // error
$response->errors[0]->code; // 1, 2 , 3

// 1 = Letter is already canceled
// 2 = Letter cannot be canceled because is already sent
// 3 = Letter has multiple addresses therefore, can not be canceled
```

**POZOR!!!** Není možné rušit dopisy, kde bylo přiřazeno více adres. Nastával by zde totiž problém, že některé dopisy by mohly být již podané a některé jestě ne. Pokud tedy chcete mít možnost využít tuto funkci, je třeba podávat dopisy vždy s jednou adresou adresáta.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 81.3% 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 ~363 days

Recently: every ~544 days

Total

7

Last Release

1678d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2070666?v=4)[Matousek](/maintainers/Matousek)[@Matousek](https://github.com/Matousek)

---

Top Contributors

[![Matousek](https://avatars.githubusercontent.com/u/2070666?v=4)](https://github.com/Matousek "Matousek (13 commits)")[![zelenaposta-dev](https://avatars.githubusercontent.com/u/92364183?v=4)](https://github.com/zelenaposta-dev "zelenaposta-dev (3 commits)")

---

Tags

apilistonoska

### Embed Badge

![Health badge](/badges/listonoska-api/health.svg)

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

###  Alternatives

[m165437/laravel-blueprint-docs

API Blueprint Renderer for Laravel

22779.0k](/packages/m165437-laravel-blueprint-docs)

PHPackages © 2026

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