*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

User

แทนที่ผู้ใช้ที่ลงทะเบียนใดๆ ของ Roblox

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของผู้ใช้

รูปแบบ: users/{user_id}.

createTimestring
เอาต์พุตเท่านั้น

เวลาที่ผู้ใช้ถูกสร้างขึ้น. สตริงนี้มีรูปแบบประทับเวลา

idstring
เอาต์พุตเท่านั้น

ID ที่ไม่ซ้ำกันที่ระบุผู้ใช้ใน Roblox.

namestring

ชื่อผู้ใช้ที่ไม่ซ้ำกันสำหรับผู้ใช้ใน Roblox.

displayNamestring

ชื่อแสดงสำหรับผู้ใช้.

aboutstring

ข้อมูลที่กำหนดเองเกี่ยวกับตัวเอง.

localestring

ภูมิภาคปัจจุบันที่ผู้ใช้เลือก ส่งคืนรหัสภาษา IETF.

premiumboolean
เอาต์พุตเท่านั้น

ว่าผู้ใช้เป็นผู้ใช้พรีเมียมหรือไม่.

idVerifiedboolean
เอาต์พุตเท่านั้น

ระบุว่าผู้ใช้ได้รับการยืนยันตัวตนหรือไม่ การตรวจสอบรวมถึง แต่ไม่ จํากัดเฉพาะหมายเลขโทรศัพท์ที่ไม่ใช่ VoIP หรือรหัสรัฐบาล

เพื่อเข้าถึงข้อมูลนี้ คุณต้องมีกุญแจ API/โทเค็น OAuth ด้วยขอบเขตต่อไปนี้: user.advanced:read.

socialNetworkProfilesobject

โปรไฟล์เครือข่ายสังคมและการมองเห็นของผู้ใช้.

URL หลัก
https://apis.roblox.com
แหล่งข้อมูล 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

รับผู้ใช้
เวอร์ชัน Beta

GET /cloud/v2/users/{user_id}

รับข้อมูลพื้นฐานและขั้นสูงของผู้ใช้

เพื่อดูข้อมูลสาธารณะของผู้ใช้ไม่จำเป็นต้องมีขอบเขตเพิ่มเติม

เพื่อดูสถานะการตรวจสอบของผู้ใช้คุณต้องมีขอบเขตต่อไปนี้:

  • ผู้ใช้.advanced:อ่าน

เพื่อดูข้อมูลบัญชีโซเชียลของผู้ใช้ คุณต้องมีขอบเขตต่อไปนี้:

  • ผู้ใช้.social:อ่าน
คำขอพารามิเตอร์เส้นทาง
user_idstring
จำเป็นต้องมี

ID ผู้ใช้.

การตอบกลับUser
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}'
การตอบกลับ
{

  "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

สร้างภาพขนาดย่อของผู้ใช้
เวอร์ชัน Beta

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

สร้างและส่งคืน URL สําหรับภาพนิ่งของอวตารผู้ใช้

คำขอพารามิเตอร์เส้นทาง
user_idstring
จำเป็นต้องมี

ID ผู้ใช้.

พารามิเตอร์คิวรี
sizenumber

ขนาดของภาพตัวอย่างที่สร้างขึ้น ภาพตัวอย่างที่สร้างขึ้นจะมีมิติ size * size

ขณะนี้สนับสนุนค่าต่อไปนี้: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 ค่าเริ่มต้นคือ 420.

formatEnum<string>

ระบุรูปแบบของภาพตัวอย่างที่สร้างขึ้น ค่าเริ่มต้นคือ PNG

มูลค่าที่เป็นไปได้:

| ค่า | คําอธิบาย | | --- | --- | | FORMAT_UNSPECIFIED | รูปแบบภาพผู้ใช้เริ่มต้น -- ตั้งค่าเป็น png | | PNG | สร้างภาพย่อในรูปแบบ .png | | JPEG | สร้างภาพย่อในรูปแบบ .jpg |. ค่าที่เป็นไปได้:

shapeEnum<string>

ระบุรูปแบบของภาพตัวอย่าง ค่าเริ่มต้นคือ ROUND (วงกลม)

มูลค่าที่เป็นไปได้:

| ค่า | คําอธิบาย | | --- | --- | | SHAPE_UNSPECIFIED | รูปภาพผู้ใช้เริ่มต้น -- ตั้งเป็นกลม | | กลม | สร้างภาพเป็นวงกลม| | สแควร์ | สร้างภาพขนาดย่อเป็นรูปสี่เหลี่ยม |. ค่าที่เป็นไปได้:

การตอบกลับ

วิธีนี้ไม่ได้ทำพร้อมกันและส่งคืน Operation ซึ่งแสดงสถานะปัจจุบันของการดำเนินการและมีเส้นทาง Endpoint ที่คุณใช้สำรวจความคิดเห็นได้ เพื่อเช็คการตอบสนองจริงและข้อมูลเมตาที่เกี่ยวข้อง หากต้องการข้อมูลเพิ่มเติม โปรดดูเอกสารเกี่ยวกับการดำเนินการที่ใช้เวลานาน

ส่วนต่อไปนี้จะอธิบายการตอบสนองและวัตถุข้อมูลเมตาที่จะได้รับเมื่อดำเนินการเสร็จสิ้น

การตอบกลับ

ส่งคืน URL สำหรับภาพนิ่งของอวตารของผู้ใช้

imageUristring

URI สำหรับภาพขนาดย่อที่สร้างขึ้น.

ข้อมูลเมต้า

ไม่มี

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