*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

User

Roblox'un kayıtlı herhangi bir kullanıcısını temsil eder.

Nitelikler

pathstring

Kullanıcının kaynak yolu.

Biçim: users/{user_id}.

createTimestring
Yalnızca Çıkış

Kullanıcının oluşturulduğu tarih ve saat. Bu dizi Timestamp olarak biçimlendirilmiş.

idstring
Yalnızca Çıkış

Roblox'ta bir kullanıcıyı tanımlayan benzersiz bir kimlik.

namestring

Roblox'taki bir kullanıcı için benzersiz kullanıcı adı.

displayNamestring

Kullanıcı için görünen adı.

aboutstring

Kendileriyle ilgili kullanıcı tarafından tanımlanan bilgiler.

localestring

Kullanıcı tarafından seçilen mevcut yerel. IETF dil kodunu döndürür.

premiumboolean
Yalnızca Çıkış

Kullanıcının premium kullanıcı olup olmadığı.

idVerifiedboolean
Yalnızca Çıkış

Kullanıcının kimlik doğrulandığını belirler. Doğrulama, VoIP telefon numaraları veya hükümet kimlikleri dahil değildir, ancak sınırlı değildir.

Bu verilere erişmek için, aşağıdaki alanla bir API anahtarı/OAuth jetonuna ihtiyacınız var: user.advanced:read.

socialNetworkProfilesobject

Kullanıcının sosyal ağ profilleri ve görünürlüğü.

Taban URL
https://apis.roblox.com
User Kaynağı
{

  "path": "users/123",

  "createTime": "2023-07-05T12:34:56Z",

  "id": "123456",

  "name": "exampleUser",

  "displayName": "userDefinedName",

  "about": "Example User's bio",

  "locale": "en-US",

  "premium": true,

  "idVerified": true,

  "socialNetworkProfiles": {

    "facebook": "string",

    "twitter": "string",

    "youtube": "string",

    "twitch": "string",

    "guilded": "string",

    "visibility": "SOCIAL_NETWORK_VISIBILITY_UNSPECIFIED"

  }

}

User

Kullanıcıyı Al
Beta

GET /cloud/v2/users/{user_id}

Bir kullanıcının temel ve gelişmiş bilgilerini alır.

Bir kullanıcının halka açık bilgilerine erişmek için ek çerçevelere gerek yoktur.

Bir kullanıcının doğrulama durumuna erişmek için, aşağıdaki alanlara ihtiyacınız var:

  • kullanıcı.gelişmiş:okuma

Bir kullanıcının sosyal hesap bilgilerine erişmek için, aşağıdaki alanlara ihtiyacınız var:

  • user.social:okunma
TalepYol Parametreleri
user_idstring
Gerekli

Kullanıcı kimliği.

YanıtUser
GET /cloud/v2/users/{user_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/users/{user_id}' \

  -H 'x-api-key: {your-api-key}'
Yanıt
{

  "path": "users/123",

  "createTime": "2023-07-05T12:34:56Z",

  "id": "123456",

  "name": "exampleUser",

  "displayName": "userDefinedName",

  "about": "Example User's bio",

  "locale": "en-US",

  "premium": true,

  "idVerified": true,

  "socialNetworkProfiles": {

    "facebook": "string",

    "twitter": "string",

    "youtube": "string",

    "twitch": "string",

    "guilded": "string",

    "visibility": "SOCIAL_NETWORK_VISIBILITY_UNSPECIFIED"

  }

}

User

Kullanıcı Thumbnail'ı Oluştur
Beta

GET /cloud/v2/users/{user_id}:generateThumbnail

Kullanıcının avatar miniatürü için URL'yi oluşturur ve geri döndürür.

TalepYol Parametreleri
user_idstring
Gerekli

Kullanıcı kimliği.

Sorgu Parametreleri
sizenumber

Oluşturulan küçük resmin boyutu. Oluşturulan küçük resim size * size boyutuna sahip olacak.

Şu anda desteklenen değerler: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720Varsayılan değer 420'dir.

formatEnum<string>

Oluşturulan küçük resmin biçimini belirtin.Varsayılan değer PNG dir.

Olası değerler:

| Değer | Açıklama | | --- | --- | | FORMAT_UNSPECIFIED |Varsayılan Kullanıcı ThumbnailFormatı -- png'ye ayarlanır | | PNG | .png formatında küçük resim oluştur | | JPEG | .jpg formatında küçük resim oluştur |. Olası değerler:

shapeEnum<string>

Küçük resmin şeklini belirtin. Varsayılan değer ROUND (dairesel).

Olası değerler:

| Değer | Açıklama | | --- | --- | | SHAPE_UNSPECIFIED | Varsayılan Kullanıcı Thumbnail Şekli -- yuvarlak olarak ayarlanır | | YUVARLAK | Yüksek çözünürlükte bir daire oluştur.| | MEYDAN | Bir kare olarak küçük resim oluştur. |. Olası değerler:

Yanıt

Eş zamansız olan bu yöntem, işlemin geçerli durumunu temsil eden bir Operation döndürür Gerçek yanıtı ve uygulanabilir üst verileri elde etmek için yoklayabileceğin bir uç nokta yolu içerir. Daha fazla bilgi için uzun süreli işlemlerle ilgili dokümantasyonu incele.

Aşağıdaki kısımlar, bir işlem tamamlandığında sağlanan yanıt ve üst veri nesnelerini tanımlar.

Yanıt

Kullanıcının avatar miniatürü için URL'yi döndürür.

imageUristring

Oluşturulan küçük resmin URI'si.

Üst Veri

Hiçbiri

GET /cloud/v2/users/{user_id}:generateThumbnail
curl -L -X GET 'https://apis.roblox.com/cloud/v2/users/{user_id}:generateThumbnail?size={integer}&format={string}&shape={string}' \

  -H 'x-api-key: {your-api-key}'