5 kroků, jak proběhne první REST API a co ho zdrží
Důvěra se neprojeví jen v poslušnosti. Poznáte ji podle toho, že pes se na vás obrací, když se lekne, že se vrací, když ho zavoláte, že se u vás uvolní. To je základ, na kterém postavíte jakýkoliv výcvik. Bez něj budete mít možná poslušného psa, ale ne parťáka. A rozdíl mezi tím je přesně to, co dělá společný život spokojeným.<br>
<br>
<br>
<br>
Zrcadlo není dekorace, ale zdroj svět<br>
<br>
<br>
<br>
Kdy je poškození vadou a kdy už ne Rozhodující je okamžik převzetí. Pokud byl balík poškozený už při doručení, je to vada, kterou musí řešit prodávající. Jestliže jste ale převzetí potvrdili bez výhrad a krabice byla v pořádku, může prodejce namítat, že škoda vznikla až u vás. Proto se vyplatí při převzetí od kurýra sepsat protokol o škodě, pokud je obal zjevně poničený. Když kurýr odmítne, poznamenejte to do podpisového pole nebo odmítněte převzetí.<br>
<br>
<br>
<br>
Typické chyby, které lidem kradou peníze: vyhození původního obalu, fotografování až po úplném rozbalení, komunikace pouze po telefonu a čekání déle než pár dní. Zákonná lhůta pro vyřízení reklamace je třicet dnů, ale čím dříve ji podáte, tím menší prostor pro dohady. Pokud prodejce odmítne reklamaci uznat, požádejte o písemné zdůvodnění a pak se obraťte na Českou obchodní inspekci nebo na soud. Většina sporů se ale vyřeší už v prvním e-mailu – když jsou fotky jasné, požadavek konkrétní a tón věcný.<br>
<br>
<br>
<br>
Dalším kamenem úrazu je nesoulad mezi členy domácnosti. Jeden pes venčí na vodítku, druhý ho nechá tahat. Jeden ho krmí u stolu, druhý to zakazuje. Pes se pak učí, že pravidla jsou vratká, a začne si hledat vlastní cestu. Sjednoťte se alespoň v základech – kde pes spí, jak se chová u dveří, jak reagujete na štěkání. Nemusíte být dokonalí, ale musíte být konzistentní.<br>
<br>
<br>
<br>
Stavové kódy a chybové odpovědi Stavový kód není formalita. 200 znamená úspěch, 201 vytvoření, 204 smazání bez těla. 400 je chyba na straně klienta, 401 chybějící autentizace, 403 nedostatečné oprávnění, 404 neexistující zdroj, 409 konflikt, 422 neplatná data. 500 je chyba serveru a nemá unikat do odpovědi s detailem. Do těla chyby dejte strojově čitelný kód a krátkou zprávu. Nikdy nevracejte 200 s polem error — klient to přehlédne a vy budete ladit hodiny.<br>
<br>
<br>
<br>
U světla myslete na teplotu a směr. Studené bílé světlo v malé předsíni zvýrazní každou nerovnost a působí chladně; teplé bílé je příjemnější, ale při slabém výkonu dělá místnost ještě menší. Vhodné je kombinovat celkové světlo ze stropu s doplňkovým světlem u zrcadla. Svítidlo umístěte před zrcadlo nebo nad něj, nikdy ne za hlavu — jinak si při pohledu do zrcadla budete stínit obličej.<br>
<br>
<br>
<br>
Důvěra mezi psem a člověkem nevzniká z ničeho. Není to vlastnost, kterou pes dostane do vínku, ani výsledek toho, že mu občas dáte pamlsek. Je to vztah, který se buduje každý den – opakovanými situacemi, ve kterých pes zjistí, že se na vás může spolehnout. Teprve na takovém základu má smysl cokoliv cvičit. Bez důvěry bude každý povel jen bojem o pozici a každý výcvik jen zdrojem napětí.<br>
<br>
<br>
<br>
Začněte návrhem zdrojů, ne kódu. Zdroj je podstatné jméno v množném čísle: /uzivatele, /objednavky. Vyhněte se slovesům v cestě (/getUzivatel) i hlubokému vnořování. Vztah mezi zdroji řešte cestou, ne parametry: /uzivatele/42/objednavky. Filtr, řazení a stránkování patří do query parametrů. Tento krok zabere hodinu a ušetří týdny přepisování, až se API rozroste.<br>
<br>
<br>
<br>
Reklamaci podejte písemně, ideálně e-mailem s potvrzením o doručení. Uveďte, co je poškozené, přiložte fotografie a napište, co požadujete – opravu, výměnu, slevu, nebo vrácení peněz. Pokud jde o vadu, kterou nelze odstranit, máte nárok na výměnu věci nebo na odstoupení od smlouvy. Nezapomeňte uvést číslo bankovního účtu, pokud chcete peníze zpět převodem. Vyhněte se telefonátům: ústní domluva se špatně dokazuje.<br>
<br>
<br>
<br>
Než ale cokoli nafotíte, zastavte se a udělejte tři věci. Zaprvé vyfoťte balík ještě před otevřením, včetně etikety a jakéhokoli viditelného poškození obalu. Zadruhé vyfoťte obsah tak, jak jste ho vyndali – nerozbalený, položený vedle krabice. Zatřetí si připravte číslo objednávky a datum doručení. Bez těchto tří informací se reklamace táhne týdny, protože prodejce bude tvrdit, že škodu způsobil až kurýr při předání, případně že jste si ji způsobili sami.<br>
<br>
<br>
<br>
Testujte požadavek ještě před psaním klientského kódu. Nástroj příkazové řádky vám ukáže přesné hlavičky i tělo. Ověřte, co se stane při chybějícím tokenu, při neplatném JSON a při neexistujícím ID. Právě tyto tři případy tvoří většinu produkčních incidentů. Výsledek si uložte jako sadu příkladů, které poběží při každé změně.