Aracılığıyla paylaş


REST API sürümü oluşturma

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Sürümlenmiş REST API'lerini kullanarak, projelerinizin zaman içinde ölçeklenebilir ve sürdürülebilir olduğundan ve uygulamalarınızın ve hizmetlerinizin API'ler geliştikçe çalışmaya devam ettiğinden emin olabilirsiniz.

Yönergeler

  • API sürümü her istekle belirtilmelidir .

  • API sürümleri biçimindedir {major}.{minor}[-{stage}[.{resource-version}]]. Örneğin: 1.0, 1.1, 1.2-preview, 2.0

  • Api önizleme aşamasındayken, gerektiğinde API'nin belirli bir düzeltmesinin kesin bir sürümünü belirtebilirsiniz. Örneğin: 1.0-preview.1, 1.0-preview.2

  • Bir API yayımlandıktan sonra (1.0örneğin), önizleme sürümü (1.0-preview) kullanım dışı bırakılır ve 12 hafta sonra devre dışı bırakılabilir.

  • Bu süre boyunca API’nin yayımlanan sürümüne yükseltmeniz gerekir. Önizleme API’si devre dışı bırakıldığında, -preview sürümünü belirten istekler reddedilir.

Kullanım

API sürümü HTTP isteğinin üst bilgisinde veya URL sorgu parametresi olarak belirtilebilir:

HTTP isteği üst bilgisi:

Accept: application/json;api-version=1.0

Uri sorgu parametresi:

[scheme"://"][host[':'port]]"/v" major-version '/'namespace '/'resource ('/'resource)* '?' query

i.e. GET https://dev.azure.com/v1.0/{organization}/_apis/{area}/{resource}?some-query=1000

Desteklenen sürümler

Uyarı

Desteklenen tüm Rest API'ler Azure DevOps Services REST API Başvurusu'nda belgelenmiştir.

Team Foundation Server, 2019'da Azure DevOps Server olarak yeniden adlandırıldı.

Ürün 1.0 2.0 3.0 4,0 5.0 6,0 7.0
Azure DevOps Services X X X X X X X
Azure DevOps Server 2022 X X X X X X X
Azure DevOps Server 2020 X X X X X X -
Azure DevOps Server 2019 X X X X X - -
Team Foundation Server 2018 X X X X - - -
Ekip Temel Sunucusu 2017 X X X - - - -
Team Foundation Server 2015 X X - - - - -

Ana API sürümü sürümleri Team Foundation Server RTM sürümleriyle uyumludur. Örneğin, 3.0 API kümesi Team Foundation Server 2017 ile kullanıma sunulmuştur.

Team Foundation Server 2013'te birkaç belgelenmemiş sürüm 1.0 API'si var, ancak desteklenmiyor.