Stručně: API je smluvené rozhraní, přes které si softwarové systémy předávají požadavky a data. Jeho dokumentace určuje dostupné operace, vstupy, výstupy, ověření a limity.
Jak API používám v praxi
V praxi odděluji prototyp s API od produkčního procesu. Prototyp má ověřit užitek; produkce potřebuje oprávnění, limity, monitoring a náhradní postup. Výstup nepovažuji za fakt jen proto, že zní přesvědčivě, a u důležitých tvrzení dohledávám původní zdroj.
Na co si dát pozor
Největší riziko je automatizovat nejasný proces. API pak rychleji vyrábí nekonzistentní výstup a chybu je těžší dohledat. Pozor také na citlivá data, neznámé podmínky služby a rozhodnutí, která nelze jednoduše vrátit.
Otázky pro rozhodnutí
- Který úzký úkol má technologie zlepšit?
- Jaká data smí použít a kdo kontroluje výstup?
- Na jakých reálných případech změříme přesnost a náklady?
- Jak proces zastavíme nebo vrátíme při chybě?