Wikis - Get

Usługa:

Wiki

Wersja interfejsu API:

7.1

Pobiera witrynę typu wiki odpowiadającą podanemu identyfikatorowi wiki lub nazwie witryny typu wiki.

GET https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}?api-version=7.1

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
wikiIdentifier	path	True	string	Identyfikator witryny typu wiki lub nazwa witryny typu wiki.
project	path		string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WikiV2	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Zakresy

Nazwa	Opis
vso.wiki	Umożliwia odczytywanie stron typu wiki, stron typu wiki i załączników typu wiki. Ponadto umożliwia wyszukiwanie stron typu wiki.

Przykłady

Query by Id

Query by name

Query by Id

Przykładowe żądanie

HTTP

GET https://dev.azure.com/fabrikam/_apis/wiki/wikis/{wikiIdentifier}?api-version=7.1

Przykładowa odpowiedź

Kod stanu:

200

{
  "id": "0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "versions": [
    {
      "version": "wikiMaster"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_apis/wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "remoteUrl": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "type": "projectWiki",
  "name": "sampleProjectWiki",
  "projectId": "15cbba90-8ac5-450e-934c-16f43021546b",
  "repositoryId": "0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "mappedPath": "/"
}

Query by name

Przykładowe żądanie

HTTP

GET https://dev.azure.com/fabrikam/_apis/wiki/wikis/{wikiIdentifier}?api-version=7.1

Przykładowa odpowiedź

Kod stanu:

200

{
  "id": "0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "versions": [
    {
      "version": "wikiMaster"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_apis/wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "remoteUrl": "https://dev.azure.com/fabrikam/15cbba90-8ac5-450e-934c-16f43021546b/_wiki/wikis/0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "type": "projectWiki",
  "name": "sampleProjectWiki",
  "projectId": "15cbba90-8ac5-450e-934c-16f43021546b",
  "repositoryId": "0ede3074-ce9f-4e0e-b9d6-20c23b774e05",
  "mappedPath": "/"
}

Definicje

Nazwa	Opis
GitVersionDescriptor
GitVersionOptions	Opcje wersji — określ dodatkowe modyfikatory do wersji (np. Poprzednie)
GitVersionType	Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany
WikiType	Typ strony typu wiki.
WikiV2	Definiuje zasób typu wiki.

GitVersionDescriptor

Objekt

Nazwa	Typ	Opis
version	string	Identyfikator ciągu wersji (nazwa tagu/gałęzi, SHA1 zatwierdzenia)
versionOptions	GitVersionOptions	Opcje wersji — określ dodatkowe modyfikatory do wersji (np. Poprzednie)
versionType	GitVersionType	Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany

GitVersionOptions

Wyliczanie

Opcje wersji — określ dodatkowe modyfikatory do wersji (np. Poprzednie)

Wartość	Opis
firstParent	Pierwszy element nadrzędny zatwierdzenia (HEAD^)
none	Nie określono
previousChange	Zatwierdzanie zmienionego elementu przed bieżącą wersją

GitVersionType

Wyliczanie

Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany

Wartość	Opis
branch	Interpretowanie wersji jako nazwy gałęzi
commit	Interpretowanie wersji jako identyfikatora zatwierdzenia (SHA1)
tag	Interpretowanie wersji jako nazwy tagu

WikiType

Wyliczanie

Typ strony typu wiki.

Wartość	Opis
codeWiki	Wskazuje, że witryna typu wiki została opublikowana z repozytorium git
projectWiki	Wskazuje, że witryna typu wiki jest aprowizowana dla projektu zespołowego

WikiV2

Objekt

Definiuje zasób typu wiki.

Nazwa	Typ	Opis
id	string (uuid)	Identyfikator witryny typu wiki.
isDisabled	boolean	Czy repozytorium wiki jest wyłączone
mappedPath	string	Ścieżka folderu wewnątrz repozytorium, które jest wyświetlane jako wiki. Typ ProjectWiki nie jest wymagany.
name	string	Nazwa witryny typu wiki.
projectId	string (uuid)	Identyfikator projektu, w którym ma zostać utworzona witryna typu wiki.
properties	object	Właściwości witryny typu wiki.
remoteUrl	string	Zdalny internetowy adres URL witryny typu wiki.
repositoryId	string (uuid)	Identyfikator repozytorium git, które wykonuje kopię zapasową witryny typu wiki. Typ ProjectWiki nie jest wymagany.
type	WikiType	Typ strony typu wiki.
url	string	Adres URL REST dla tej witryny typu wiki.
versions	GitVersionDescriptor[]	Wersje witryny typu wiki.