*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

User

Đại diện cho bất kỳ người dùng đã đăng ký nào của Roblox.

Thuộc Tính

pathstring

Con đường tài nguyên của người dùng.

Định dạng: users/{user_id}.

createTimestring
Chỉ Xuất

Thời gian chạy của người dùng được tạo tại. Chuỗi này được định dạng là Dấu thời gian.

idstring
Chỉ Xuất

ID duy nhất xác định một người dùng trong Roblox.

namestring

Tên người dùng duy nhất cho một người dùng trong Roblox.

displayNamestring

Tên hiển thị cho người dùng.

aboutstring

Thông tin được định nghĩa bởi người dùng về bản thân.

localestring

Vị trí hiện tại được chọn bởi người dùng. Trả về mã ngôn ngữ IETF.

premiumboolean
Chỉ Xuất

Whether người dùng là người dùng cao cấp.

idVerifiedboolean
Chỉ Xuất

Xác định xem người dùng đã được xác minh danh tính hay chưa. Xác minh bao gồm, nhưng không giới hạn, các số điện thoại không phải là VoIP hoặc ID chính phủ.

Để truy cập dữ liệu này, bạn cần một chìa khóa API / OAuth với phạm vi sau: user.advanced:read.

socialNetworkProfilesobject

Hồ sơ mạng xã hội và khả năng hiển thị của người dùng.

URL Cơ Sở
https://apis.roblox.com
Tài nguyên 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

Nhận người dùng
Bản Beta

GET /cloud/v2/users/{user_id}

Nhận thông tin cơ bản và nâng cao của người dùng.

Để truy cập thông tin công khai của một người dùng, không cần thêm phạm vi nào khác.

Để truy cập tình trạng xác minh của người dùng, bạn cần các phạm vi sau:

  • user.advanced: đọc

Để truy cập thông tin tài khoản mạng xã hội của một người, bạn cần các phạm vi sau:

  • user.social:đọc
Yêu CầuTham Số Đường Dẫn
user_idstring
Bắt Buộc

ID người dùng.

Phản HồiUser
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}'
Phản Hồi
{

  "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

Tạo hình ảnh người dùng
Bản Beta

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

Tạo và trả về URL cho hình ảnh thumbnail avatar của người dùng.

Yêu CầuTham Số Đường Dẫn
user_idstring
Bắt Buộc

ID người dùng.

Tham Số Truy Vấn
sizenumber

Kích thước của hình ảnh thu nhỏ được tạo. Hình ảnh thu nhỏ được tạo sẽ có size * size chiều.

Hiện đang hỗ trợ các giá trị: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 Mặc định là 420.

formatEnum<string>

Xác định định dạng hình ảnh thu nhỏ được tạo. Mặc định là PNG .

Các giá trị có thể:

| Giá trị | Mô tả | | --- | --- | | FORMAT_UNSPECIFIED | Định dạng hình ảnh mặc định -- set to png | | PNG | Tạo hình ảnh thumbnail trong .png format | | JPEG | Tạo hình ảnh thumbnail trong .jpg format |. Giá trị có thể:

shapeEnum<string>

Xác định hình dạng của thumbnail. Mặc định là ROUND (vòng tròn).

Các giá trị có thể:

| Giá trị | Mô tả | | --- | --- | | SHAPE_UNSPECIFIED | Hình ảnh người dùng mặc định -- đặt thành tròn | | TRÒN | Tạo hình ảnh là một vòng tròn.| | SQUARE | Tạo thumbnail như một hình chữ nhật. |. Giá trị có thể:

Phản Hồi

Phương pháp này không đồng bộ và trả về một "Hoạt Động" cho biết trạng thái hiện tại của hoạt động. Phương pháp chứa một đường dẫn điểm cuối mà bạn có thể thăm dò để nhận về phản hồi thực tế và siêu dữ liệu hiện hành. Xem [tài liệu] (/cloud/reference/patterns#long-running-operations) về các hoạt động kéo dài để biết thêm thông tin.

Các phần dưới đây mô tả những phản hồi và siêu dữ liệu có được khi một hoạt động hoàn thành.

Phản Hồi

Trả về URL cho hình ảnh thumbnail avatar của người dùng.

imageUristring

URI cho hình ảnh thu nhỏ được tạo.

Siêu dữ liệu

Không Có

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