REST Design
-
Guidelines
Přehled pravidel, na základě kterých je tento průvodce napsán
-
Úvod
Úvod do Průvodce designem REST API
-
Historie REST
Stručná historie REST API a souvislosti do současnosti
-
R. T. Fielding
Jak R. T. Fielding ovlivnil HTTP protokol a dnešní pohled na REST
-
L. Richardson
Model Leonarda Richardsona a vliv na současnou podobu REST API
-
Pravidla a standardy
Standard a konvence v moderních webových službách
-
Specification First
Principy návrhu webových služeb metodou specification first
-
HTTP protokol
Na jakých principech je postaven HTTP protokol
-
URL Design
Jak správně navrhnout kompletní podobu URL
-
Resources
Co jsou resources a jak správně navrhovat podobu URL
-
Query Design
Filtrování, stránkování a řazení v kolekcích
-
HTTP Metody
HTTP metody pro vytváření standardních CRUD operací
-
HTTP Patch
Jak může posloužit PATCH metoda při částečné aktualizaci
-
Operations, RPC
Návrh endpointů, které mají provádět v REST API různé operace
-
Stavové kódy
Jak fungují stavové kódy a jaké stavové kódy používat
-
Message Design
Jak mají vypadat JSON struktury posílané do a z API
-
Formát dat
V jakém formátu mají být data, která se zpracovávají v REST API
-
HATEOAS
Jak pomáhají HATEOAS propojit resources mezi sebou
-
Asynchronní API
Jak správně navrhnout API endpointy, které zpracovávají data asynchronně
-
Verzování
Jak správně přistupovat k verzování REST API
-
HTTP hlavičky
Využití standardních a vlastních HTTP hlaviček
-
Content Negotiation
Jak se může client a server domluvit na formátu zasílaných dat
-
HTTP Cache
Princip cachování na straně klienta pomocí HTTP hlaviček
-
Same Origin a CORS
Bezpečnostní politika Same Origin a rozšíření API o CORS
-
Autentizace
Jak funguje autentizace a autorizace v REST API
-
Zabezpečení
Desítky zásad jak správně zabezpečit REST API