User_no_avatar

lukaszlewand


About


Navrhovat verzování REST API bez rozbití stávajících klientů znamená především přijmout fakt, že změna je nevyhnutelná, ale její dopad lze řídit. Základním pravidlem je zavést verzování hned od počátku, i když API oslovuje jen interní aplikace. Nejjednodušší a nejpragmatičtější cestou je umístit verzi do URL, tedy například /api/v1/uzivatele. Tento přístup je srozumitelný, snadno se debuguje a klienti ho vidí na první pohled. Alternativou je verze v hlavičce, ale to komplikuje testování a je to méně transparentní pro lidi, kteří API konzumují. Pokud teprve začínáš, drž se číselné verze v URL a nikdy neměň její sémantiku – v1 znamená jednou provždy v1. www.vyvojarska.cz se tak situacím, kdy bys musel zpětně měnit chování pro staré dotazy.


<img width="314" src="https://vyvojarska.cz/wp-content/uploads/2026/08/l8QsVMgT8wHRlSV9Ewcp3_d18fc7bd824e46478ad7f8baf38719fc.jpg">



Když potřebuješ přidat novou funkcionalitu, ne vždy mu