API işjeň ösende, wersiýalaryň arasynda gabat gelmek we bir üýtgeşme onlarça müşderi integrasiýasyny bozýan ýagdaýlardan gaça durmak möhümdir. Üýtgeşmelere gözegçilik etmäge we ulanyjylar üçin töwekgelçiliksiz API-leri ýuwaş täzelemäge mümkinçilik berýän şertnamalaryň doly wersiýasyny amala aşyrýarys.
Bu mikroservis arhitekturasynda, B2B integrasiýasynda we dürli müşderileriň interfeýsleriň dürli wersiýalaryny ulanýan açyk API önümlerinde möhüm ähmiýete eýe.
Näme wersiýa edýäris
| Obýekt | Düşündiriş |
|---|---|
| OpenAPI aýratynlyklary | Resminamalaryň we şertnamanyň her bir wersiýasyny saklaýarys |
| Endpoint'ы | URL-e wersiýalary goşýarys ('/v1/', '/v2/'), backward compatibility saklaýarys |
| Şertnamalar (Pact, Dredd) | Müşderi bilen serweriň arasyndaky özara gatnaşyklaryň şertlerini düzetmek |
| Maglumat modelleri | Haýyşnamanyň we jogabyň gurluşyndaky üýtgeşmelere gözegçilik etmek |
Nädip durmuşa geçirýäris
Parallel birnäçe API wersiýasyny goldamak
URL-de, sözbaşylarda ýa-da parametrlerde wersiýany aç-açan görkezmek
Şertnamalaryň her wersiýasyny awtomatiki barlamak (Pact, Postman, Jest, Dredd)
Aýratynlyklary Git ýa-da CI/CD arkaly wersiýalaşdyrmak
Her üýtgeşmede müşderiler üçin resminamalar we changelog
Artykmaçlyklary
Integrasiýalaryň kepillendirilen durnuklylygy
Müşderileri "döwmek" töwekgelçiligi bolmazdan täze aýratynlyklary çykarmak ukyby
Wersiýalaryň arasynda göçmegi ýönekeýleşdirmek
Üýtgeşmeleriň aýdyň taryhy we kontraktlara gözegçilik
Daşarky we içerki ösüş toparlary üçin aç-açanlyk
Bu ýerde aýratyn möhümdir
Köp garaşlylygy bolan mikroservis arhitekturasy
Jemgyýetçilik ýa-da B2B API platformalary
Uzak möhletli şertnamalary bolan maliýe we töleg ulgamlary
Durnukly API interfeýsine bagly ykjam programmalar
Şertnamalary wersiýalaşdyrmak API-de öňünden aýdylýanlygyň we ynamyň esasyny düzýär. API-leri agyrysyz üýtgetmäge we ösdürmäge mümkinçilik berýän prosesleri durmuşa geçirýäris, ähli taraplar üçin laýyklygy we aç-açanlygy saklaýarys.