Backend a API

Serverová část rozhoduje o tom, jak rychlá a spolehlivá aplikace je. Navrhujeme API, datový model a provozní chování služby tak, aby se daly měnit bez výpadku klientů.

API navrhujeme s ohledem na to, že klientské aplikace se aktualizují pomalu a část uživatelů zůstává na starých verzích měsíce. Rozhraní proto verzujeme a rozšiřujeme zpětně kompatibilně; odstranění pole je změna, která se plánuje, ne která se vydá ve čtvrtek odpoledne.

Datový model navrhujeme dřív než obrazovky. Migrace verzujeme spolu s kódem a spouštíme automaticky při nasazení, takže prostředí se nerozcházejí. Autentizaci, omezení počtu požadavků a záznam operací považujeme za součást zadání, ne za pozdější doplněk. Měření zavádíme od začátku: bez záznamů a metrik se první výpadek řeší hádáním.

Co je součástí

Návrh API a datového modelu
Autentizace, oprávnění a omezení požadavků
Migrace databáze verzované s kódem
Fronty, plánované úlohy a zpracování na pozadí
Záznamy, metriky a upozornění na chyby
Automatické sestavení a nasazení

Co dostanete

Dokumentace API generovaná z kódu
Infrastruktura popsaná v repozitáři
Přístupy k prostředím na vaše jméno
Postup nasazení a návratu k předchozí verzi

Co sledujeme

Doba odpovědi v horním percentilu, ne v průměru
Podíl chybových odpovědí
Doba nasazení a doba návratu k předchozí verzi
Úspěšnost zpracování front

Hodnoty těchto ukazatelů předem neslibujeme — závisí na produktu a jeho uživatelích. Slibujeme, že je budeme měřit a ukazovat.

Časté otázky

Můžete pracovat s naší stávající infrastrukturou?

Ano. Začínáme přehledem toho, co běží a kde, a navrhujeme změny po krocích. Přesun do jiného prostředí je samostatné rozhodnutí, ne podmínka spolupráce.

Jak řešíte změny API u již vydaných aplikací?

Rozhraní rozšiřujeme zpětně kompatibilně a verzujeme. Starší verze vypínáme až podle podílu uživatelů, kteří na ní zůstali, a po ohlášení termínu.

Poptávka: Backend a API

Napište nám, o co jde. Odpovíme z adresy na této doméně a shrneme písemně, jak jsme zadání pochopili.