Aracılığıyla paylaş

REST API sürümü oluşturma

  • Makale

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Sürüm oluşturulmuş REST API’leri kullanarak, API’ler geliştikçe uygulamalar ve hizmetler çalışmaya devam ederken projelerinizin zaman içinde ölçeklenebilir ve sürdürülebilir olmasını sağlayabilirsiniz.

Yönergeler

  • API sürümü her istekle belirtilmelidir .
  • API sürümleri {major} biçimindedir. {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 tam sürümünü belirtebilirsiniz (örneğin, 1.0-preview.1, 1.0-preview.2).
  • API yayımlandıktan sonra (örneğin 1.0 sürümü), önizleme sürümü (1.0-önizleme) kullanım dışı bırakılır ve 12 hafta sonra ise 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

Urı:

[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

Ü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 - -
Team Foundation Server 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.