Versioning API: `/v1/`, `Accept: version`, `GraphQL alias`

API ösende täze usullar, parametrler we logika peýda bolýar. Şol bir wagtyň özünde häzirki müşderileriň işini bozmazlyk üçin API wersiýasy ulanylýar. Biz birnäçe wersiýa çemeleşmelerini goldaýarys, integratorlara interfeýsiň zerur wersiýasyny durnukly işlemek üçin töwekgelçiliksiz ulanmaga mümkinçilik berýäris.

Bu platforma ulalanda-da, täzelenmeleri girizmekde, köne müşderileri synagdan geçirmekde ýa-da olara hyzmat etmekde-de möhümdir.


Wersiýa usullary

UsulDüşündiriş we artykmaçlyklar
URL wersiýasy ('/v1/')Iň düşnükli we meşhur usul - REST API üçin amatly
Accept sözbaşyMysal: 'Accept: application/vnd. api+json; version = 2 '- maglumatlary wersiýadan aýyrýar
GraphQL alias / versioned fieldsAliýalar arkaly dürli wersiýalar: 'userV1', 'userV2' - kem-kemden göçmek üçin amatly
Shema derejesindäki wersiýalarHer wersiýa üçin OpenAPI/Swagger-de aýratyn shemalar we modullar

Nädip amala aşyryldy

API gurluşy s '/v1/', '/v2/' we garaşsyz marşrutlar

"Accept" we "X-API-Version" sözbaşylaryny barlamak
  • GraphQL aliýalary we wersiýaly shemalary goldaýar ('userV1', 'userV2')
  • Önümçilik üçin töwekgelçiliksiz täze wersiýalary A/B synap görmek ukyby
  • Her wersiýa ýüzlenmeleri seljermek we göçmek üçin logirlemek

Işewürlik we integratorlar üçin artykmaçlyklar

Ösüş haýallamazdan köne müşderileri goldamak
  • Birnäçe nesil API-iň paralel işi
  • Täze funksiýalary ters gabat gelmezden howpsuz ornaşdyrmak
  • Infrastrukturany giňeltmekde we täzelemekde çeýeligi
  • Gözegçilik we seljeriş wersiýalarynyň arasynda aç-açan göçmek

Bu ýerde aýratyn möhümdir

Daşarky müşderileri köp bolan platformalar
  • API-first çemeleşmesi we uzak ömri bolan taslamalar
  • Banklar, üpjün edijiler, B2B-hyzmatdaşlar bilen integrasiýa
  • Uzak ömürli ykjam ýa-da IoT-müşderileri bolan ulgamlar

API wersiýasy integrasiýalaryň ygtybarlylygynyň we çeýeliginiň esasyny düzýär. Formatyna garamazdan (REST, GraphQL ýa-da gRPC), interfeýsleriň howpsuz ösüşini üpjün edýäris - şowsuzlyksyz, gapma-garşylyksyz we laýyklyk ýitirilmezden.

Biziň bilen habarlaşyň

Aşakdaky formany dolduryň, biz gysga wagtda jogap bereris.