Úvod k API v2
Zaslat API v2 je nová generace veřejného API, která vzniká postupně vedle API v1. Zatím pokrývá práci s košíkem rozpracovaných zásilek (OmniCart) a rušení objednávek svozu; další oblasti budou přibývat.
Kompletní referenci endpointů, parametrů a datových schémat najdete v API Referenci.
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ů.
Košík (OmniCart)
Košík obsahuje rozpracované zásilky — připravené, ale dosud závazně neobjednané. Endpoint
cart/create založí v košíku koncept zásilky se zadanou trasou, balíky a doplňkovými
službami; nic se v tu chvíli neobjednává ani neúčtuje. Odpověď vrací kromě identifikátoru
konceptu i dostupné nabídky přepravy (rates), případně seznam nedostatků v datech (errors).
Zásilky z košíku pak zkontrolujete, opravíte a závazně objednáte v
Manažeru zásilek.
Stejný princip košíku využívají e-shopové integrace a MCP server — API v2 je cesta, jak košík plnit z vlastního systému.
Rušení svozů
Endpoint collection-request/cancel zruší objednaný svoz u daného dopravce pro zadané datum.
Autentizace
Všechny požadavky je nutné posílat s autentizačním HTTP headerem x-apikey — stejně jako u
API v1. API klíč najdete po přihlášení do Manažeru zásilek
(app.zaslat.cz) v sekci Nastavení → Integrace, část
Napojení pomocí API.
Vztah k API v1
API v1 zůstává v provozu beze změn — nadále slouží k získávání nabídek přepravy, závaznému objednávání zásilek, sledování a správě adresáře. API v2 jej doplňuje o scénář „připravit teď, objednat později": zásilky vložené do košíku přes API v2 dokončíte hromadně v Manažeru zásilek.