Úvod k API v1
Zaslat API v1 slouží k získávání nabídek přepravy, vytváření a správě zásilek, žádostem o svoz, čtení číselníku podacích/výdejních míst a správě adresáře kontaktů.
Kompletní referenci endpointů, parametrů a datových schémat najdete v API Referenci. Tato sekce doplňuje kontext a rozšíření, která se do referenční dokumentace nehodí.
Kompletní OpenAPI specifikaci si můžete stáhnout ve formátu YAML — hodí se pro import do nástrojů (Postman, Insomnia) i jako podklad pro AI agenty a generátory klientů.
Autentizace
Všechny požadavky je nutné posílat s autentizačním HTTP headerem x-apikey. Produkční API klíč
najdete ve správním rozhraní (app.zaslat.cz) v sekci API (Nastavení
uživatele).
Testovací prostředí
Pro vývoj a ladění integrace je k dispozici oddělené testovací prostředí na adrese
https://test.zaslat.cz/api/v1. Testovací API klíč získáte stejným postupem v testovacím
správním rozhraní na app-test.zaslat.cz — účty a data jsou od
produkce zcela oddělené.
Obsah sekce
- API Reference — kompletní přehled endpointů, parametrů a datových schémat.
- Objednávka celní zásilky — rozšíření endpointu pro vytvoření
zásilky o objekt
customspotřebný pro celní řízení. - Objednávka ze svozové adresy — objednávka zásilek ze
svozové adresy s vlastním tiskem štítků (typ
OCCASIONAL). - Dobírka (COD) — pravidla dobírky: povolené směry a měny, bankovní účet, minimální částky a omezení dopravců.
- Doručení na výdejní místo — objednávka s podáním nebo doručením na výdejní místo (parcel shop / box).
- Sledování zásilek a stavy — životní cyklus zásilky a doporučený způsob sledování stavu.
- Mapový widget — interaktivní mapa podacích a výdejních míst pro vložení do vašeho webu, kterou si můžete přímo vyzkoušet.
- Příklady implementace — ukázky volání API v jazyce PHP.