Versioning API: `/v1/`, `Accept: version`, `GraphQL alias`
Bu həm platformanın miqyasını artırarkən, həm də yeniləmələri tətbiq edərkən, sınaqdan keçirərkən və ya köhnə müştərilərə xidmət edərkən vacibdir.
Version üsulları
| Üsul | Təsviri və üstünlükləri |
|---|---|
| URL versiyası ('/v1/') | Ən aydın və məşhur üsul - REST API üçün əlverişli |
| Accept başlığı | Nümunə: 'Accept: application/vnd. api+json; version = 2 '- versiya məlumatlarını ayırır |
| GraphQL alias/versioned fields | Alias vasitəsilə müxtəlif versiyalar: 'userV1', 'userV2' - tədricən miqrasiya üçün əlverişlidir |
| Sxem səviyyəsində versiyalar | Hər bir versiya üçün OpenAPI/Swagger-də ayrı-ayrı sxemlər və modullar |
Necə həyata keçirilmişdir
API strukturu '/v1/', '/v2/' və müstəqil marşrutlarla
'Accept' və 'X-API-Version' başlıqlarının yoxlanılması
GraphQL alias və versiyalı sxemləri dəstəkləyir ('userV1', 'userV2')
A/B istehsal üçün risk olmadan yeni versiyaları test etmək imkanı
Analiz və miqrasiya üçün hər bir versiyaya müraciətlərin loqosu
Biznes və inteqratorlar üçün üstünlüklər
Yavaşlamadan köhnə müştərilərə dəstək
Bir neçə nəsil API paralel iş
Geri uyğunluğu pozmadan yeni funksiyaların təhlükəsiz tətbiqi
Infrastrukturun genişləndirilməsi və yenilənməsində çeviklik
Nəzarət və analitika ilə versiyalar arasında şəffaf miqrasiya
Harada xüsusilə vacibdir
Bir çox xarici müştəriləri olan platformalar
API-first yanaşma və uzun həyat dövrü ilə layihələr
Banklar, provayderlər, B2B tərəfdaşları ilə inteqrasiya
Uzun ömürlü mobil və ya IoT müştəriləri olan sistemlər
API versiyası inteqrasiyanın etibarlılığı və çevikliyinin əsasını təşkil edir. Formatdan (REST, GraphQL və ya gRPC) asılı olmayaraq, biz təhlükəsiz interfeys inkişafını təmin edirik - heç bir nasazlıq, münaqişə və uyğunluq itkisi olmadan.
Bizimlə əlaqə saxlayın
Aşağıdakı formanı doldurun, ən qısa zamanda cavab verəcəyik.