Chapter 21: Versioning

Verzování REST API je nevyhnutelný proces, který představuje pro vývojářský tým značnou zátěž. Ještě než si položíte otázku "Jak verzovat API", doporučuji strávit čas otázkou "Co můžeme udělat proto, abychom verzovat nemuseli". Možná vás napadne mnoho možností, jak potřebu verzování maximálně oddálit.

Od zpřístupnění REST API vývojářské veřejnosti začnou probíhat integrace, které později zabraňují zásahům do aktuální podoby REST API. Jakákoliv změna musí být zpětně kompatibilní s předchozí verzí API, aby nedošlo k defektu v existujících integracích. To je důvod, proč se chceme verzování pokud možno vyhnout. Není to jednoduché, ale jeden tip bych měl.

Během návrhu REST API si neustále pokládajete otázku, jaké nové scénáře mohou vzniknout a zda jste schopni je realizovat se zachování zpětné kompatibility. I když nepokryjete všechny okrajové scénáře, základní scénáře byste měli být vždy schopni implementovat, aniž by to klient zaznamenal. Pokud ne, upravte design tak, aby to šlo.