API белсенді дамығанда, нұсқалар арасындағы үйлесімділікті сақтау және бір өзгеріс ондаған клиенттік интеграцияны бұзатын жағдайларды болдырмау маңызды. Біз өзгерістерді бақылауға және пайдаланушылар үшін тәуекелсіз API-ны біртіндеп жаңартуға мүмкіндік беретін келісімшарттардың толыққанды нұсқасын іске асырудамыз.
Бұл микросервистік архитектурада, B2B интеграцияларында және әртүрлі клиенттер интерфейстердің әртүрлі нұсқаларын пайдаланатын ашық API өнімдерінде өте маңызды.
Біз не нұсқалаймыз
| Нысан | Сипаттамасы |
|---|---|
| OpenAPI спецификациясы | Құжаттаманың және келісімшарттың әрбір нұсқасын сақтаймыз |
| Endpoint'ы | URL ('/v1/', '/v2/') нұсқаларын қосамыз, backward compatibility сақтаймыз |
| Келісімшарттар (Pact, Dredd) | Клиент пен сервер арасындағы өзара іс-қимыл шарттарын белгілеу |
| Деректер үлгілері | Сұрау салу мен жауап құрылымындағы өзгерістерді бақылау |
Біз қалай іске асырамыз
Параллельді бірнеше API нұсқаларын қолдау
Нұсқаны URL, тақырып немесе параметрлерде анық көрсету
Келісімшарттардың әрбір нұсқасын автотестеу (Pact, Postman, Jest, Dredd)
Спецификацияларды Git немесе CI/CD арқылы нұсқалау
Әрбір өзгерісте клиенттер үшін құжаттама және changelog
Артықшылықтары
Интеграцияның кепілдендірілген тұрақтылығы
Клиенттерді «сындыру» тәуекелінсіз жаңа фичтер шығару мүмкіндігі
Нұсқалар арасындағы көші-қонды жеңілдету
Өзгерістердің нақты тарихы және келісімшарттарды бақылау
Сыртқы және ішкі игеру командалары үшін ашықтық
Ерекше маңызды жерде
Көптеген тәуелділіктері бар микросервистік архитектура
Көпшілік немесе B2B API платформалары
Ұзақ мерзімді келісімшарттары бар қаржы және төлем жүйелері
Тұрақты API интерфейсіне тәуелді мобильді қосымшалар
Келісімшарттарды нұсқалау - бұл API-дегі болжамдылық пен сенімнің негізі. Біз барлық тараптарға үйлесімділік пен ашықтықты сақтай отырып, API-ны ауыртпалықсыз өзгертуге және дамытуға мүмкіндік беретін процестерді енгіземіз.