Zaslat Returns API

API rozhraní systému Zaslat Returns pro správu servisních zakázek (reklamace, záruční a pozáruční servis, poptávky služeb) a přidružených zásilek.

Prostředí

• Produkční rozhraní běží na doméně konkrétní společnosti, např. https://nokia.zaslat.cz/api/v1/<resource>.
• Testovací rozhraní je dostupné na https://returns-demo.zaslat.cz/api/v1/<resource>. Upozornění: veškeré změny provedené v testovacím prostředí se každou noc mažou a prostředí je znovu vytvořeno.

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í v sekci API (Nastavení uživatele), testovací klíč je uveden níže u schématu zabezpečení ApiKeyAuth.

⚠️ Poznámka k úplnosti specifikace: Tato specifikace byla sestavena ze zdrojové Notion dokumentace. Čtyři vložené tabulky (parametry filtrování zakázek, tělo požadavku pro úpravu zakázky a objekty customer a shipment) nebyly v době vzniku specifikace čitelné kvůli omezení Notion plánu — jejich pole byla proto rekonstruována z ukázkových JSON požadavků a odpovědí v dokumentaci. Tyto části jsou v popisech níže označeny ⚠️ a doporučujeme je před nasazením do produkčního klienta ověřit proti zdrojové tabulce nebo backendu.