V mnoha projektech vznikají API velmi rychle.
Přidá se controller.
Vytvoří se endpoint.
Vrátí se DTO.
Na začátku to působí jako malý technický krok, jen další část práce potřebná k dokončení funkce.
Postupem času se ale API stává něčím mnohem důležitějším.
Stává se smlouvou mezi systémy.
Mezi týmy.
A někdy dokonce mezi firmami.
A na rozdíl od mnoha jiných částí systému mají API jednu zajímavou vlastnost — často přežijí velmi dlouho.
Týmy se mění.
Projekty se vyvíjejí.
Architektura se postupně přepisuje.
Ale API často zůstává.
Právě proto patří promyšlený návrh API v .NET mezi technická rozhodnutí s největším dlouhodobým dopadem.
Ne proto, že by byl nutně složitý.
Ale proto, že malá rozhodnutí se v čase násobí.
Jasné pojmenování.
Konzistentní struktura zdrojů.
Předvídatelné odpovědi.
Verzování respektující existující klienty.
Každé z těchto rozhodnutí může na první pohled působit jako detail.
Dobře navržené API přináší do systému především srozumitelnost.
Vývojáři rychle pochopí, jak ho používat.
Noví členové týmu se snadněji zapojují do projektu.
Integrace mezi systémy jsou předvídatelnější.
A možná ještě důležitější je jedna věc. Systém zůstává flexibilní i ve chvíli, kdy postupně roste.
Protože dobrý návrh API není jen o dnešní funkcionalitě.
Je hlavně o možnostech budoucího vývoje.
API totiž často přežije i tým, který ho vytvořil.
A rozhodnutí, která dnes vypadají jako malé technické detaily, tak mohou nenápadně ovlivňovat podobu systému ještě mnoho let.