*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

User

Mewakili setiap pengguna terdaftar dari Roblox.

Atribut

pathstring

Jalur sumber daya pengguna.

Format: users/{user_id}.

createTimestring
Hanya Output

Stempel waktu di mana pengguna dibuat. String ini diformat sebagai Timestamp.

idstring
Hanya Output

ID unik yang mengidentifikasi pengguna di Roblox.

namestring

Nama pengguna unik untuk pengguna di Roblox.

displayNamestring

Nama tampilan untuk pengguna.

aboutstring

Informasi yang didefinisikan pengguna tentang diri mereka sendiri.

localestring

Lokasi saat ini yang dipilih oleh pengguna. Kembalikan kode bahasa IETF.

premiumboolean
Hanya Output

Apakah pengguna adalah pengguna premium.

idVerifiedboolean
Hanya Output

Menentukan apakah pengguna diverifikasi identitas. Verifikasi termasuk, tetapi tidak terbatas pada, nomor telepon non-VoIP atau ID pemerintah.

Untuk mengakses data ini, Anda membutuhkan kunci API/token OAuth dengan scope berikut: user.advanced:read.

socialNetworkProfilesobject

Profil dan visibilitas jaringan sosial pengguna.

Base URL
https://apis.roblox.com
Resource User
{

  "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

Dapatkan Pengguna
Beta

GET /cloud/v2/users/{user_id}

Mendapatkan informasi dasar dan lanjutan pengguna.

Untuk mengakses informasi publik pengguna, tidak diperlukan scope tambahan.

Untuk mengakses status verifikasi pengguna, Anda membutuhkan scope berikut:

  • pengguna.advanced:dibaca

Untuk mengakses informasi akun sosial pengguna, Anda membutuhkan scope berikut:

  • pengguna.social:baca
PermintaanParameter Jalur
user_idstring
Diperlukan

ID pengguna.

ResponsUser
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}'
Respons
{

  "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

Hasilkan Thumbnail Pengguna
Beta

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

Membuat dan mengembalikan URL untuk thumbnail avatar pengguna.

PermintaanParameter Jalur
user_idstring
Diperlukan

ID pengguna.

Parameter Kueri
sizenumber

Ukuran thumbnail yang dihasilkan. Thumbnail yang dihasilkan akan memiliki dimensi size * size.

Nilai yang didukung saat ini: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 Nilai default adalah 420.

formatEnum<string>

Spesifikasikan format thumbnail yang dihasilkan. Nilai default adalah PNG .

Nilai yang mungkin:

| Nilai | Deskripsi | | --- | --- | | FORMAT_UNSPECIFIED | Format Gambar Pengguna Default - ditetapkan ke png | | PNG | Hasilkan gambar dalam format .png format | | JPEG | Hasilkan gambar dalam format .jpg format |. Nilai yang mungkin:

shapeEnum<string>

Spesifikasikan bentuk thumbnail. Default adalah ROUND (lingkaran).

Nilai yang mungkin:

| Nilai | Deskripsi | | --- | --- | | SHAPE_UNSPECIFIED | Bentuk Gambar Pengguna Default - ditetapkan untuk bulat | | BULAT | Hasilkan gambar sebagai lingkaran.| | SQUARE | Hasilkan thumbnail sebagai segi empat. |. Nilai yang mungkin:

Respons

Metode ini tidak sinkron dan menghasilkan sebuah Operasi, yang mewakili keadaan operasi saat ini. Operasi tersebut berisi jalur endpoint yang dapat Anda pantau untuk memperoleh respons aktual dan metadata yang relevan. Lihat dokumentasi tentang operasi jangka panjang untuk mengetahui informasi selengkapnya.

Bagian berikut menjelaskan objek respons dan metadata yang disediakan saat operasi selesai.

Respons

Kembalikan URL untuk thumbnail avatar pengguna.

imageUristring

URI untuk thumbnail yang dihasilkan.

Metadata

Tidak ada

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}'