Cizí služba ve tvojí aplikaci

Napojení na cizí službu vypadá jako zkratka. Většinou to zkratka je – ale je to taky závazek.

Co si tím bereš

1. Závislost na cizí dostupnosti

   Když je jejich služba mimo provoz, tvoje aplikace přijde o funkci. Tvoji uživatelé to poznají, i když je chyba jinde.

2. Závislost na jejich změnách

   Změní rozhraní, zdraží, zruší funkci. Musíš reagovat.

3. Náklady, které rostou s používáním

   Zdarma do tisíce požadavků. Když aplikace uspěje, začne to stát peníze.

4. Odpovědnost za data

   Když jim posíláš údaje o svých uživatelích, zodpovídáš za to ty.

Neznamená to, že se cizím službám má člověk vyhýbat. Platební brána, odesílání e-mailů nebo mapy jsou věci, které si nikdo rozumný nepíše sám.

Znamená to, že u každé takové volby má padnout vědomé rozhodnutí.

Kdy ano a kdy ne

Podle čeho službu vybrat

1. Dokumentace

   Nejlepší předpověď toho, jak bude spolupráce vypadat. Špatná dokumentace znamená hodiny hádání.

2. Ceník včetně toho, co se stane při růstu

   Ne jen kolik stojí teď. Kolik to bude stát při desetinásobku.

3. Testovací prostředí

   Umíš to vyzkoušet bez skutečných plateb a skutečných e-mailů? U platebních bran je to nutnost.

4. Jak se to chová při chybě

   Vrací srozumitelné chyby, nebo jen „něco se pokazilo“?

Potřebuju v aplikaci [CO POTŘEBUJEŠ – např. posílat transakční e-maily].

Kontext:
- Aplikace je [POPIS], očekávaný objem je [ODHAD].
- Působím v Česku / EU.
- Rozpočet: [ČÁSTKA NEBO „minimální“].

Porovnej mi tři možnosti a u každé napiš:
1. Kolik to stojí teď a při desetinásobku.
2. Jak složité je to napojit.
3. Jestli má testovací prostředí.
4. Co se stane, když služba vypadne.
5. Kde běží data a jestli je to problém z pohledu GDPR.

Na konci mi doporuč jednu a napiš proč. Kde si nejsi jistý aktuálními
cenami nebo podmínkami, řekni to a odkaž mě na oficiální stránku.

Jedno místo pro jednu službu

Praktické pravidlo, které ti ušetří spoustu práce: všechna komunikace s jednou cizí službou má být na jednom místě v projektu.

Napojíme aplikaci na [SLUŽBA] kvůli [ÚČEL].

Pravidla:
- Veškerá komunikace s touhle službou jen v jednom souboru.
- Zbytek aplikace ji volá přes jednoduché funkce v češtině významu,
ne přes detaily jejich rozhraní.
- Klíč čti z proměnné prostředí, nikdy z kódu.
- Volání jen ze serveru, nikdy z prohlížeče.
- Ošetři chybu: co se stane, když služba neodpoví nebo vrátí chybu.

Než začneš:
1. Podívej se do jejich aktuální dokumentace.
2. Popiš mi, jak to chceš udělat.
3. Řekni mi, jaké proměnné prostředí budu muset nastavit.