Pecka Advent 10. prosince

Dokumentace API v Excelu – ano, nebo ne?

E-commerce svět bychom si mohli rozdělit na dvě základní oblasti. První z nich je to, co vidí zákazník a druhá, co je mu skryto. Nepoměr mezi nimi je obrovský, klidně si troufnu říct, že kód, na který má zákazník šanci si „sáhnout“ je cca 20 %. A co tvoří zbytek? Synchronizace s externími systémy, které jsou čím dál častěji stavěny na REST API.

Napsat neprůstřelnou synchronizaci s externím systémem, není nikdy triviální úkol. Jedna věc ho ale může buďto zjednodušit, a nebo z něj udělat horor – dokumentace.

Přečtěte si, jaká byla naše cesta k aktuálním a pravdivým dokumentacím, které nám ve výsledku usnadňují práci.