Profiles - Get
Mendapatkan profil pengguna.
GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?api-version=7.1-preview.3
GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?details={details}&withAttributes={withAttributes}&partition={partition}&coreAttributes={coreAttributes}&forceRefresh={forceRefresh}&api-version=7.1-preview.3
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
id
|
path | True |
string |
ID profil pengguna target dalam organisasi yang sama, atau 'saya' untuk mendapatkan profil pengguna yang diautentikasi saat ini. |
api-version
|
query | True |
string |
Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.3' untuk menggunakan versi api ini. |
core
|
query |
string |
Daftar atribut profil inti yang dibatasi koma untuk dikembalikan. Nilai yang valid adalah Email, Avatar, DisplayName, dan ContactWithOffers. |
|
details
|
query |
boolean |
Mengembalikan informasi profil publik seperti nama tampilan, alamat email, negara, dll. Jika false, parameter withAttributes diabaikan. |
|
force
|
query |
boolean |
Tidak digunakan dalam versi API ini. |
|
partition
|
query |
string |
Partisi (grup bernama) atribut yang akan dikembalikan. |
|
with
|
query |
boolean |
Jika true, mendapatkan atribut (bernama pasangan kunci-nilai data arbitrer) yang terkait dengan profil. Parameter partisi juga harus memiliki nilai. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
operasi berhasil |
Keamanan
oauth2
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL:
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
Scopes
Nama | Deskripsi |
---|---|
vso.profile | Memberikan kemampuan untuk membaca profil, akun, koleksi, proyek, tim, dan artefak organisasi tingkat atas lainnya. |
Contoh
Sample Request
GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?api-version=7.1-preview.3
Sample Response
{
"displayName": "Normal Paulk",
"publicAlias": "d6245f20-2af8-44f4-9451-8107cb2767db",
"emailAddress": "fabrikamfiber16@hotmail.com",
"coreRevision": 1647,
"timeStamp": "2014-05-12T22:23:07.727+00:00",
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"revision": 1647
}
Definisi
Nama | Deskripsi |
---|---|
Attribute |
Mengidentifikasi atribut dengan nama dan kontainer. |
Attributes |
Menyimpan sekumpulan atribut profil bernama. |
Core |
Atribut profil yang selalu memiliki nilai untuk setiap profil. |
Profile |
Profil pengguna. |
Profile |
Objek bernama yang terkait dengan profil. |
Profile |
Status profil saat ini. |
AttributeDescriptor
Mengidentifikasi atribut dengan nama dan kontainer.
Nama | Jenis | Deskripsi |
---|---|---|
attributeName |
string |
Nama atribut . |
containerName |
string |
Kontainer tempat atribut berada. |
AttributesContainer
Menyimpan sekumpulan atribut profil bernama.
Nama | Jenis | Deskripsi |
---|---|---|
attributes |
<string,
Profile |
Atribut yang disimpan oleh kontainer. |
containerName |
string |
Nama kontainer. |
revision |
integer |
Jumlah revisi maksimum atribut apa pun dalam kontainer. |
CoreProfileAttribute
Atribut profil yang selalu memiliki nilai untuk setiap profil.
Nama | Jenis | Deskripsi |
---|---|---|
descriptor |
Pendeskripsi atribut . |
|
revision |
integer |
Nomor revisi atribut. |
timeStamp |
string |
Waktu atribut terakhir diubah. |
value |
string |
Nilai atribut |
Profile
Profil pengguna.
Nama | Jenis | Deskripsi |
---|---|---|
applicationContainer |
Atribut profil ini. |
|
coreAttributes |
<string,
Core |
Atribut inti profil ini. |
coreRevision |
integer |
Jumlah revisi maksimum dari atribut apa pun. |
id |
string |
Pengidentifikasi unik profil. |
profileState |
Status profil saat ini. |
|
revision |
integer |
Jumlah revisi maksimum dari atribut apa pun. |
timeStamp |
string |
Waktu di mana profil ini terakhir diubah. |
ProfileAttribute
Objek bernama yang terkait dengan profil.
Nama | Jenis | Deskripsi |
---|---|---|
descriptor |
Pendeskripsi atribut . |
|
revision |
integer |
Nomor revisi atribut. |
timeStamp |
string |
Waktu atribut terakhir diubah. |
value |
string |
Nilai atribut |
ProfileState
Status profil saat ini.
Nama | Jenis | Deskripsi |
---|---|---|
custom |
string |
Profil sedang digunakan. |
customReadOnly |
string |
Profil sedang digunakan, tetapi hanya dapat dibaca. |
readOnly |
string |
Profil hanya dapat dibaca. |