Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
Med hjälp av versionsbaserade REST-API:er kan du se till att dina projekt är skalbara och underhållsbara över tid och att dina program och tjänster fortsätter att fungera alltefter som API:er utvecklas.
Riktlinjer
API-versionen måste anges för varje begäran.
API-versioner är i formatet
{major}.{minor}[-{stage}[.{resource-version}]]. Till exempel:1.0,1.1,1.2-preview,2.0När ett API är i förhandsversion kan du ange en exakt version av en viss revision av API:et när det behövs. Till exempel:
1.0-preview.1,1.0-preview.2När ett API har släppts (
1.0till exempel) är dess förhandsversion (1.0-preview) inaktuell och kan inaktiveras efter 12 veckor.Under den här tiden bör du uppgradera till den utgivna versionen av API:et. När ett förhandsversions-API har inaktiverats avvisas begäranden som anger en
-previewversion.
Användning
API-versionen kan anges antingen i huvudet på HTTP-begäran eller som en URL-frågeparameter:
HTTP-begärandehuvud:
Accept: application/json;api-version=1.0
Uri-frågeparameter:
[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
Versioner som stöds
Anmärkning
Alla rest-API:er som stöds dokumenteras i REST API-referensen för Azure DevOps Services.
Team Foundation Server bytte namn till Azure DevOps Server 2019.
| Produkt | 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 | - | - | - | - | - |
Större VERSIONER av API-versioner överensstämmer med Team Foundation Server RTM-versioner. API-uppsättningen introducerades till exempel 3.0 med Team Foundation Server 2017.
Några odokumenterade VERSION 1.0-API:er fanns i Team Foundation Server 2013, men stöds inte.