Chapter 09: Design Patterns

Máme-li již základní znalosti o collection resources a object resources, podíváme se na klíčové návrhové vzory pro tvorbu URL. Nezapomeňte si přečíst i část antipatterns, kde naleznete podobné příklady s nesprávným použitím.

Nested Resource

Začněme patternem, který je podle mého názoru často nadužívaný. Vytváření nested resource má smysl pouze v případech, kdy hlavní resource obsahuje kolekci, jejíž identifikátor není jedinečný v rámci celého systému.

/orders/20220203001/addresses/delivery
/orders/20220203001/addresses/billing
/articles/39047664/revisions/1
/articles/39047664/revisions/2

Příklad výše předpokládá, že objednávka má dva typy adres: doručovací a fakturační. Identifikátory delivery a billing nejsou samy o sobě nejsou unikátní v rámci celého REST API, ale v kombinaci s číslem objednávky ano. Podobné je to i v případě revisions.