Вақте ки API таҳаввул меёбад, методҳо, параметрҳо ва мантиқи нав пайдо мешаванд. Бо мақсади халалдор накардани кори мизоҷони кунунӣ, версияи API истифода мешавад. Мо якчанд равишҳоро ба версия дастгирӣ мекунем, ки ба интеграторҳо имкон медиҳад, ки версияи дилхоҳи интерфейсро бидуни хатар барои кори устувор истифода баранд.
Ин ҳам ҳангоми васеъ кардани платформа ва ҳам ҳангоми татбиқи навсозиҳо, озмоиш ё хидматрасонии муштариёни кӯҳна муҳим аст.
Усулҳои версия
| Усул | Тавсиф ва фоидаҳо |
|---|---|
| Версия дар URL ('/v1/') | Роҳи аз ҳама фаҳмо ва маъмул барои REST API қулай аст |
| Қабул кардани сарлавҳа | Мисол: 'Қабул: ариза/внд. api + json; версия = 2 '- маълумотро аз версия ҷудо мекунад |
| Тахаллуси графикӣ/майдонҳои санҷидашуда | Версияҳои гуногун тавассути тахаллусҳо: 'user |
| Версияҳои сатҳи схема | Диаграммаҳо ва модулҳои ҷудогона дар Open/API/Swagger барои ҳар як версия |
Чӣ тавр амалӣ карда шуд
Сохтори API бо '/v1/', '/v2/' ва хатсайрҳои мустақил
Санҷиши сарлавҳаҳои 'Қабул' ва 'X-API-Version'
GraphL тахаллусҳо ва схемаҳои санҷидашударо дастгирӣ мекунад ('user
Қобилияти A/B версияҳои навро бидуни хатар барои истеҳсол озмоиш мекунад
Сабти зангҳо ба ҳар як версия барои таҳлил ва муҳоҷират
Манфиатҳои тиҷорат ва интегратор
Муштариёни кӯҳнаро бе суст шудан дастгирӣ кунед
Амалиёти параллелии насли API
Хусусиятҳои навро бидуни шикастани мутобиқати қафо бехатар иҷро кунед
Тағйирпазирӣ ба миқёс ва навсозии инфрасохтор
Муҳоҷирати бефосила байни версияҳои назоратшаванда ва таҳлилӣ
Дар куҷо махсусан муҳим
Платформаҳо бо муштариёни сершумори беруна
Лоиҳаҳо бо равиши аввалини API ва давраи дарозмуддат
Интегратсия бо бонкҳо, провайдерҳо, шарикони B2B
Системаҳо бо муштариёни дарозмуддати мобилӣ ё IOT
Версияи API асоси эътимоднокӣ ва тағйирпазирӣ дар ҳамгироӣ мебошад. Сарфи назар аз формат (REST, GraphL ё GRPC), мо рушди бехатари интерфейсҳоро таъмин мекунем - бидуни нокомӣ, муноқишаҳо ва аз даст додани мутобиқат.