NoREST API alias Not Only RESTful API

V dnešní době se stává API důležitou součástí businessu a dobré API je klíčem k úspěchu. Existuje mnoho názorů, jak by API mělo vypadat a fungovat. Z slova “RESTful” se stal buzzword, který často neodpovídá skutečnosti. Jak tedy má vypadat RESTful API? Je vůbec REST tou správnou cestou? A co to ten REST vlastně je? V tomto kurzu se Vám pokusím odpovědět na tyto a další otázky.

Cílová skupina

• Kurz je určený pro začínající i pokročilé programátory a software architekty.

Cíle kurzu

Podíváme se společně na samotnou REST architekturu, na její principy a pravidla. Ukážeme si, jak určit, jak dobré API vlastně je. Projdeme společně konvence při navrhování API. Předvedeme si specifikaci, která splňuje většinu REST požadavků. Ukážeme si nástroje pro práci s API, od dokumentace až po testy. Vysvětlíme si rozdíl mezi API dokumentací a kontraktem. Projdeme způsoby zabezpečení komunikace. Na závěr se pobavíme o přínosech a omezeních RESTu a o možných alternativách.

Osnova

LAB

• Návrh API dle vašich standardů
• Analýza návrhů

REST Architecture

• Co to je
• Jak to funguje
• 6 zakladnich omezeni
• HATEOAS

Richardson Maturity Model

• CRUD

HTTP

• Headers
• Content Negotiation
• Status Code

Konvence

• URI
• Parametry
• Filtrace
• Razeni
• Limitace
• Inkluze
• Sparing

JSON:API Specification

LAB

• Úprava návrhu podle informací, které jste se dozvěděli
• Diskuse nad návrhy a detailní rozbor zvolených postupů

Dokumentace

• Nastroje
• Formáty

API Contract

Security

• OAuth
• mTLS

Caching

• Server
• Client

Alternativy

• RPC
• SOAP
• GraphQL

Předpoklady účastníka

• Očekává se znalost fungování HTTP a Webu.

Technické požadavky (BYOD)

• Vlastní počítač
• Nainstalovaný Postman (https://www.postman.com/)