Globální cloudová platforma

Veřejné API a jednotné chybové kódy

Oblast: SaaS platformy
Zákazník: Quadient

Standardizace veřejných rozhraní zkrátila integraci zákazníků a dala vývojářům předvídatelný způsob práce s chybami.

Cíl řešení3 dnyintegrace místo 3 týdnů

Cíl řešení15 mink prvnímu funkčnímu napojení

Rozsah≈ 4 000sjednocených chybových stavů

Výchozí situace

Co bylo potřeba změnit

Produkty používaly odlišné způsoby pojmenování, verzování a vracení chyb. Nová integrace proto trvala až tři týdny a změny mohly narušit zpětnou kompatibilitu.

Naše odpovědnost

Jak jsme k řešení přistoupili

Navrhli jsme firemní standard REST API, pravidla názvosloví, verzování, deprekace a breaking changes. Současně jsme sjednotili přibližně 4 000 aplikačních i infrastrukturních chybových stavů.

Součást dodání

Ucelený rozsah

API standard a governance
Asynchronní public API
Strategie verzování a deprekace
Chybový model napříč aplikací a infrastrukturou

Dopad

Co zákazník získal

Standard byl navržen tak, aby zkrátil integraci nového zákazníka ze tří týdnů na tři dny.
První funkční napojení mělo být možné ukázat během 15 minut.
Pravidla se stala základem pro přepis dalších API.

Technologie a přístupy

REST API
Asynchronní zpracování
Cloud
API governance