Chapter 05: Standards vs. Conventions

REST omezení definovaná Fieldingem a model Richardsona, které jsem popsal v předchozích kapitolách, představují spíše abstraktní popis ideální komunikace v prostředí webu. Jak jistě uznáte, dosavadní poznatky nám příliš nenapoví, jak navrhnout použitelné API, které budou vývojáři milovat. Naše cesta světem REST API tak musí nevyhnutelně pokračovat ke standardům a konvencím, které za poslední dekády vznikly. Potřebovat budeme oboje.

Technické standardy definují konkrétní pravidla, která by měl vývojář při tvorbě webových služeb dodržovat. Přesto však jejich praktická aplikace často vede k odlišným výsledkům. Jak je to možné? Například standard HTTP přesně popisuje, z čeho se skládá URL, ale nijak neurčuje, jak má být URL použita pro stránkování ve webové službě. A právě zde vzniká prostor pro konvence. Postupy, které si vývojářská komunita během poslední dekády osvojila a neformálně standardizovala.