Zaslat API v1

API rozhraní Zaslat API v1 pro získávání nabídek přepravy, vytváření a správu zásilek, žádosti o svoz, výdejní/podací místa a adresář kontaktů.

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í (test.zaslat.cz) má vlastní účty i klíče — získáte je na app-test.zaslat.cz; produkční klíč na testu neplatí.

Některé endpointy (/rates/get, /shipments/create, /shipments/validate, /shipments/detail, /shipments/tracking) fungují i bez přihlášení. Požadavek s neplatným klíčem na nich neskončí chybou 401, ale zpracuje se jako nepřihlášený: objednávka pak vznikne bez vazby na váš účet (vždy s platbou ONLINE, payer je povinný) a detail zásilky vrací jen veřejná pole. Neplatný klíč se projeví až chybou 401 na endpointech, které přihlášení vyžadují (např. /shipments/label). Platnost klíče si na začátku integrace ověřte voláním GET /shipments/list.

Rozšířené specifikace

Endpoint POST /shipments/create má rozšířené varianty popsané samostatně:

• Objednávka celní zásilky — objekt customs potřebný pro celní řízení u zahraničních zásilek.
• Objednávka ze svozové adresy — vlastní tisk štítků (typ OCCASIONAL) při svozu ze smluvní adresy.
• Bezštítková zásilka PPL (SmartPIN) — příznak label_less, podání balíku bez tisku štítku pomocí šestimístného kódu.