API aktiv şəkildə inkişaf etdikdə, versiyaların uyğunluğunu qorumaq və bir dəyişikliyin onlarla müştəri inteqrasiyasını pozduğu vəziyyətlərdən qaçmaq vacibdir. Biz istifadəçilər üçün risksiz dəyişikliklərə nəzarət etmək və API-ni hamar şəkildə yeniləmək üçün tam hüquqlu müqavilə versiyasını həyata keçiririk.
Mikroservis arxitekturasında, B2B inteqrasiyasında və müxtəlif müştərilərin müxtəlif interfeys versiyalarından istifadə etdikləri açıq API məhsullarında bu çox vacibdir.
Biz nə versiyası
| Obyekt | Təsvir |
|---|---|
| OpenAPI xüsusiyyətləri | Sənədlərin və müqavilənin hər bir versiyasını saxlayırıq |
| Endpoint'ы | URL-ə versiyalar əlavə edin ('/v1/', '/v2/'), backward compatibility saxlayın |
| Müqavilələr (Pact, Dredd) | Müştəri və server arasında qarşılıqlı əlaqə şərtlərinin müəyyən edilməsi |
| Data modelləri | Sorğu və cavab strukturunda dəyişikliklərə nəzarət |
Necə həyata keçiririk
Paralel olaraq bir neçə API versiyasını dəstəkləyir- URL-lərdə, başlıqlarda və ya parametrlərdə açıq versiyanın göstərilməsi
- Müqavilələrin hər bir versiyasının avtomatlaşdırılması (Pact, Postman, Jest, Dredd)
- Git və ya CI/CD vasitəsilə spesifikasiya versiyası
- Hər dəyişiklik zamanı müştərilər üçün sənədləşmə və changelog
Üstünlüklər
Zəmanətli inteqrasiya sabitliyi- Müştəriləri «sındırmaq» riski olmadan yeni xüsusiyyətlər buraxmaq imkanı
- Versiyalar arasında miqrasiyanın sadələşdirilməsi
- Dəyişikliklərin dəqiq tarixi və müqavilələrə nəzarət
- Xarici və daxili inkişaf komandaları üçün şəffaflıq
Harada xüsusilə vacibdir
Bir çox asılılığı olan mikroservis arxitekturası- ictimai və ya B2B API ilə platformalar
- Uzunmüddətli müqavilələri olan maliyyə və ödəniş sistemləri
- Sabit API interfeysindən asılı mobil tətbiqlər
Müqavilələrin versiyalaşdırılması API-də proqnozlaşdırıla bilən və etimadın əsasını təşkil edir. Biz bütün tərəflər üçün uyğunluq və şəffaflığı qoruyaraq, ağrısız API-lərin dəyişdirilməsinə və inkişafına imkan verən prosesləri həyata keçiririk.
Populyar mövzular
Əsas mövzular
Bizimlə əlaqə saxlayın
Aşağıdakı formanı doldurun, ən qısa zamanda cavab verəcəyik.