\['EmailOtp' = 0, 'Passkey' = 1, 'Mật khẩu' = 2]

\['Email' = 0, 'Tên người dùng' = 1, 'Số điện thoại' = 2, 'EmailOtpSessionToken' = 3, 'AuthToken' = 4, 'Mã khóa' = 5]

\['Mật khẩu hợp lệ' = 0, 'Lỗi mật khẩu yếu' = 1, 'Lỗi mật khẩu ngắn' = 2, 'Lỗi mật khẩu giống như tên người dùng' = 3, 'Lỗi mật khẩu bị cấm' = 4, 'Lỗi chuỗi ngốn' = 5]

\['Email' = 0, 'Số điện thoại' = 1, 'RecoverySessionID' = 2]

\['Chưa định nghĩa' = 0, 'Xbox' = 1, 'Playstation' = 2, 'Web' = 3]

\['Không xác định' = 1, 'Nam' = 2, 'Nữ' = 3]

\['Email' = 0, 'SMS' = 1, 'Authenticator' = 2, 'RecoveryCode' = 3, 'SecurityKey' = 4, 'CrossDevice' = 5, 'Mật khẩu' = 6, 'Passkey' = 7]

\['Tên người dùng hợp lệ' = 0, 'Lỗi đã sử dụng' = 1, 'Lỗi giảm thiểu' = 2, 'Lỗi không có độ dài' = 3, 'Lỗi bắt đầu hoặc kết thúc với dấu gạch ngang' = 4, 'Lỗi quá nhiều dấu gạch ngang' = 5, 'Bao gồm dấu câu sai' = 6, 'Không có dấu câu sai' = 7, 'Không có dấu câu sai' = 10, 'Không có dấu câu sai' = 12]

Authentication Api v1

requestBody

0: Giấy phép đã bị từ chối cho yêu cầu này.

Yêu cầu xóa pin tài khoản từ tài khoản.

Nhận được tình trạng pin tài khoản.

Yêu cầu được thực hiện để cập nhật pin tài khoản trên tài khoản.

Roblox.Authentication.Api.Models.AccountPinRequest.

Yêu cầu khóa tài khoản có một chốt tài khoản được bật.

Roblox.Authentication.Api.Models.AccountPinRequest chứa pin nhập vào.

Tạo một tuyên bố khách hàng để được sử dụng khi tạo một vé xác thực.

request

Ký một người dùng cho Roblox và liên kết tài khoản với ID nhà cung cấp bên ngoài đã xác minh.

Đăng nhập vào một người dùng vào Roblox dựa trên phiên cung cấp bên ngoài đã xác thực của người dùng

Đăng nhập vào một người dùng vào Roblox, sau đó kết nối tài khoản Roblox với ID nhà cung cấp bên ngoài

Ký một người dùng vào Roblox và liên kết tài khoản với ID nhà cung cấp bên ngoài đã xác minh

Loại bỏ tài khoản Roblox đã đăng nhập khỏi ID nhà cung cấp bên ngoài hiện tại

identityProviderId

code

state

Chức năng gọi lại mà nhà cung cấp nhận dạng bên ngoài gọi sau khi xác minh người dùng.

0: Xác thực token thất bại  &#x20;1: Vé đăng nhập không hợp lệ.  &#x20;2: Token kết quả không hợp lệ.  &#x20;3: Người dùng không hợp lệ.  &#x20;4: Lỗi xác thực.

Điểm cuối cho việc đăng nhập với xác minh danh tính

initializeLoginRequest

3: Tên người dùng và loại phải được yêu cầu.

0: Xác thực token thất bại  &#x20;2: ID người dùng không hợp lệ.

0: Một lỗi không xác định xảy ra.

1: Tính năng này bị vô hiệu hóa.

Khởi tạo dòng đăng nhập xác định trước bằng cách trả lại một danh sách các phương pháp đăng nhập cho người dùng(s).

Roblox.Authentication.Api.Models.Yêu cầu登录.

0: Một lỗi bất ngờ đã xảy ra.&#x20;  &#x20;3: Tên người dùng và mật khẩu là bắt buộc. Vui lòng thử lại.&#x20;  &#x20;8: Không hỗ trợ đăng nhập bằng loại tên nhận dạng đã nhận.

0: Xác thực token thất bại  &#x20;1: Tên người dùng hoặc mật khẩu không chính xác.Vui lòng thử lại. 2: Bạn phải vượt qua bài kiểm tra robot trước khi đăng nhập. 4: Tài khoản đã bị khóa.Vui lòng yêu cầu đặt lại mật khẩu.&#x20;  &#x20;5: Không thể đăng nhập.Vui lòng sử dụng dấu hiệu Mạng xã hội.:\*\* 6: Vấn đề tài khoản.Vui lòng liên hệ Hỗ trợ.  &#x20;9: Không thể đăng nhập bằng thông tin được cung cấp.Cần có đăng nhập mặc định.&#x20;  &#x20;10: Nhận được thông tin xác thực không được xác minh.&#x20;  &#x20;12: Tìm thấy phiên đăng nhập hiện tại.Vui lòng đăng nhập trước tiên.&#x20;  &#x20;14: Tài khoản không thể đăng nhập.Vui lòng đăng nhập vào ứng dụng LuoBu.  &#x20;15: Quá nhiều lần thử.Vui lòng đợi một chút. 27: Tài khoản không thể đăng nhập.Vui lòng đăng nhập bằng ứng dụng VNG.

7: Quá nhiều lần thử. Vui lòng đợi một chút.

11: Dịch vụ không có sẵn. Vui lòng thử lại.

Phá vỡ phiên xác thực hiện tại.

Thoát người dùng khỏi tất cả các phiên khác.

Cơ thể yêu cầu!: Vô hiệu hóa Yêu cầu xác minh hai bước.

0: Giấy phép đã bị từ chối cho yêu cầu này. 0: Một lỗi không xác định đã xảy ra với yêu cầu.

Vô hiệu hóa một loạt các tính năng xác thực cho người dùng được chỉ định.

Thân yêu cầu.Roblox.Authentication.Api.Models.Request.FinishPasskeyRegistrationRequest.

0: Một lỗi không xác định xảy ra với yêu cầu.xc 3: Tên biệt danh khóa bảo mật không hợp lệ.

0: Xác thực token thất bại  &#x20;3: Tên biệt danh khóa bảo mật không hợp lệ.

Hoàn thành đăng ký Passkey bằng cách cung cấp các tùy chọn tạo tài khoản.

Danh sách các passkey đã đăng ký của người dùng.

Cung cấp một thử thách cho Passkey để xác minh.

0: Xác thực token thất bại  &#x20;1: Đã đạt đến giới hạn của chìa khóa thông qua đã đăng ký.

Bắt đầu đăng ký Passkey bằng cách cung cấp các tùy chọn tạo tài khoản.

0: Một lỗi không xác định xảy ra với yêu cầu.

5: Thông tin xác định người dùng và loại là bắt buộc. 6: Xác thực khóa truy cập nhiều người dùng không được hỗ trợ cho loại thẻ này.

0: Xác thực token thất bại  &#x20;4: Không có chìa khóa đăng ký cho bất kỳ người dùng nào được tìm thấy.

Khởi tạo xác minh khóa truy cập cho người dùng (c) phù hợp với nhận dạng được cung cấp.

Khởi tạo đăng ký Passkey đã xác minh trước bằng cách cung cấp các tùy chọn tạo tài khoản.

Username

Password

1: Tên người dùng và mật khẩu hợp lệ là bắt buộc. Vui lòng thử lại.

Điểm cuối để kiểm tra xem mật khẩu có hợp lệ hay không.

Mô hình xác thực Roblox.Authentication.Api.Models.PasswordValidationModel.

7: API WeChat Roblox hiện không có sẵn.

Nhận metadata cho các điểm cuối bị lãng quên

Hướng dẫn Ticket để phục hồi tài khoản.

ticket

2: Vé phục hồi tài khoản không hợp lệ

1: Tính năng này đã bị vô hiệu hóa

Nhận thông tin vé Tài khoản Quay lại

Roblox.Authentication.Api.Models.RevertAccountSubmitRequest chứa thông tin cần thiết để phục hồi tài khoản.

2: Vé phục hồi tài khoản không hợp lệ  &#x20;3: Mật khẩu không hợp lệ  &#x20;4: Mật khẩu không phù hợp  &#x20;5: Mật khẩu không thể được sử dụng  &#x20;8: Vé bảo mật tài khoản hết hạn.

0: Không xác định  &#x20;1: Tính năng này bị vô hiệu hóa

Gửi yêu cầu khôi phục tài khoản

Roblox.Authentication.Api.Models.Yêu cầu đăng ký

Yêu cầu không hợp lệ 16: ID thỏa thuận người dùng là null. 21: Cần blob chuyển đổi tài khoản trống

0: Xác thực token thất bại  &#x20;2: Captcha thất bại.  &#x20;4: Sinh nhật không hợp lệ.  &#x20;5: Tên người dùng không hợp lệ.  &#x20;6: Tên người dùng đã được sử dụng.  &#x20;7: Mật khẩu không hợp lệ.  &#x20;8: Tên người dùng và mật khẩu giống nhau.  &#x20;9: Mật khẩu quá đơn giản.  &#x20;10: Email không hợp lệ.  &#x20;11: Asset không hợp lệ.  &#x20;12: Quá nhiều lần thử.Vui lòng đợi một chút.&#x20;  &#x20;17: Phiên mật khẩu một lần không hợp lệ  &#x20;22: Giới hạn tài khoản đã đăng nhập tối đa đạt được.

3: Quá nhiều lần thử. Vui lòng đợi một chút.

Lỗi máy chủ nội bộ  &#x20;15: Chấp nhận thất bại.&#x20;  &#x20;27: Thất bại đăng ký mã khóa trước khi xác thực

Điểm cuối để đăng ký một người dùng mới

Nhận thông tin người dùng mạng xã hội nếu phương thức xác thực xã hội được liên kết với người dùng hiện tại.

Nhà cung cấp xác thực xã hội, ví dụ Facebook

provider

Thân yêu cầu cho các tham số bổ sung có thể cần thiết để kết nối lại

Yêu cầu xấu  &#x20;2: Loại cung cấp xã hội không được hỗ trợ.

Bị cấm 0: Xác thực token thất bại 3: Không thể tách rời phương pháp xác thực duy nhất.Mật khẩu trên tài khoản là bắt buộc.&#x20;  &#x20;4: Mật khẩu được cung cấp không hợp lệ.

Loại bỏ phương pháp xác minh xã hội được cung cấp khỏi người dùng Roblox hiện tại nếu nó được kết nối.

Mật khẩu hiện tại cần để xác minh rằng mật khẩu có thể được thay đổi.

Mô hình yêu cầu bao gồm mật khẩu hiện tại và mật khẩu mới.

Roblox.Web.Authentication.Passwords.PasswordResponseCodes.InvalidCurrentPassword  &#x20;HOẶC  &#x20;Roblox.Web.Authentication.Passwords.PasswordResponseCodes.InvalidPassword

Roblox.Web.Authentication.Passwords.PasswordResponseCodes.PinLocked  &#x20;0: Xác thực token thất bại

Roblox.Web.Authentication.Passwords.PasswordResponseCodes.Flooded

Thay đổi mật khẩu cho người dùng đã xác minh.

Yêu cầu thay đổi tên người dùng của Roblox.Authentication.Api.Models

5: Bạn không có đủ Robux để thay đổi tên người dùng của mình.&#x20;  &#x20;10: Tên người dùng này đã được sử dụng&#x20;  &#x20;11: Tên người dùng không phù hợp với Roblox&#x20;  &#x20;12: Tên người dùng không bắt đầu hoặc kết thúc với \_ và có thể có tối đa một \_  &#x20;13: Tên người dùng không thể bắt đầu hoặc kết thúc với \_ và có thể có tối đa một \_  &#x20;14: Tên người dùng không hợp lệ  &#x20;15: Tên người dùng không chứa thông tin riêng tư  &#x20;16: Tên người dùng không có sẵn  &#x20;17: Tên người dùng không chứa thông tin riêng tư  &#x20;18: Tên người dùng không có sẵn  &#x20;19: Tên người dùng không chứa thông tin riêng tư  &#x20;20: Tên người dùng không có sẵn  &#x20;21: Tên người dùng không chứa thông tin riêng tư  &#x20;22: Tên người dùng không có sẵn  &#x20;23: Tên người dùng không có sẵn  &#x20;24: Tên người dùng không có sẻ không có sẻ sử dụng tên người dùng không có sẻ không có sẻ có sẻ không có sử dùng không có sẻ không có sử dùng không không không không không có sẻ không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không khôngôngông không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không không kh

0: Xác thực token thất bại  &#x20;1: PIN bị khóa.  &#x20;2: Email đã xác minh bị thiếu  &#x20;3: Mật khẩu của bạn không chính xác.  &#x20;100: Sinh nhật không xác định

0: Một lỗi không xác định đã xảy ra.&#x20;  &#x20;5: Bạn không có đủ Robux để thay đổi tên người dùng của mình.

4: Tính năng hiện không có sẵn. Vui lòng thử lại sau.

Thay đổi tên người dùng của người dùng

Điểm cuối này có thể được mở rộng trong tương lai để bao gồm các tham số truy vấn khác như "startsWith"

username

Nhận được danh sách tên người dùng hiện có trên Roblox dựa trên các tham số truy vấn

20: Email không hợp lệ  &#x20;21: Điện thoại không hợp lệ  &#x20;23: Không tìm thấy tài khoản

0: Xác thực token thất bại  &#x20;11: Quá nhiều lần thử. Vui lòng đợi một chút.

Gửi một email cho tất cả các tài khoản thuộc về một email

Birthday

Context

1: Cần có một tên người dùng hợp lệ.&#x20;  &#x20;2: Cần có một sinh nhật hợp lệ hoặc người dùng đã xác minh.

Kiểm tra xem tên người dùng có hợp lệ không.

The Roblox.Authentication.Api.Models.UsernameValidationRequest.

Email

Cố gắng kiểm tra xem một email có hợp lệ không

BirthDay

Cố gắng lấy một tên người dùng hợp lệ nếu tên người dùng hiện tại đã được lấy

Cố gắng lấy một tên người dùng hợp lệ nếu tên người dùng hiện tại được lấy  &#x20;Đây là một yêu cầu POST và không nhận được giá trị tham số từ truy vấn

Kiểm tra xem người dùng hiện tại có kết nối Xbox hay không.

Bị cấm 0: Xác thực token thất bại

Loại bỏ tài khoản ROBLOX hiện tại khỏi tài khoản Xbox live.

36: Tài khoản Xbox Live không hợp lệ

Nhận các ngày liên tiếp mà người dùng Xbox đã đăng nhập.

xboxTranslateRequest

Dịch người dùng xbox sang người dùng roblox.

Tổng Quan

Trải Nghiệm

Avatar

Tài Sản

Đám Mây Nguồn Mở

Tạo

Khám Phá

Bản Địa Hóa

Phân Tích

Thiết Kế

Chia tỷ lệ

Nhóm liên kết

Kiếm tiền

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] ({longRunningOperationsLink}) 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.

Các đầu cuối beta đã sẵn sàng cho việc sử dụng công khai. Có thể xuất hiện những thay đổi bất ngờ, nhưng trường hợp này rất hiếm.

Trường này có thể được đặt khi tạo tài nguyên, nhưng không thể được sửa đổi bởi các yêu cầu tiếp theo.

Các trường này có thể được đặt khi tạo tài nguyên, nhưng không thể được sửa đổi bởi các yêu cầu tiếp theo.

Trường này có thể được cung cấp trong các yêu cầu, nhưng sẽ không bao giờ được đưa vào các phản hồi.

Mỗi Khóa API: {maxInPeriod} yêu cầu mỗi {periodInSeconds} giây cho mỗi Địa Chỉ IP

Trường này có thể được đặt thành các phản hồi, nhưng sẽ bị bỏ qua trong các yêu cầu.

Note: Rate limits can be lower during high-traffic periods. Certain endpoints have additional rate limits. [Learn more about rate limits]({link}).

{limit} yêu cầu mỗi ngày đối với mỗi người sở hữu khóa API

{limit} yêu cầu mỗi giờ đối với mỗi người sở hữu khóa API

{limit} yêu cầu mỗi phút đối với mỗi người sở hữu khóa API

{limit} yêu cầu mỗi giây đối với mỗi người sở hữu khóa API

{limit} yêu cầu mỗi ngày đối với mỗi phiên xác thực OAuth 2.0

{limit} yêu cầu mỗi giờ đối với mỗi phiên xác thực OAuth 2.0

{limit} yêu cầu mỗi phút đối với mỗi phiên xác thực OAuth 2.0

{limit} yêu cầu mỗi giây đối với mỗi phiên xác thực OAuth 2.0

Cần có các quyền khóa API sau đây để gọi ra điểm cuối này. Để biết thêm
thông tin về cách tạo các khóa thích hợp, hãy xem [Quản lý khóa API] ({apiKeyReferenceDocLink}).

Các điểm cuối sau đây có trong đường dẫn liên quan đến URL cơ sở.

Chuỗi này được định dạng là [Mặt nạ trường](/cloud/reference/types#timestamp).

Giá trị JSON có thể là `null`, `boolean`, `string`, `number`, `array` hoặc `object`.

Cần có các phạm vi sau đây để ứng dụng OAuth 2.0 của bạn sử dụng điểm cuối này. Để biết thêm thông tin về cách đăng ký ứng dụng OAuth 2.0, hãy xem [Đăng ký và đánh giá ứng dụng]({oauth2ReferenceDocLink}).

Các đối tượng sau đây mô tả payload được chấp nhận hoặc bị trả về. Xem từng điểm cuối để biết thêm thông tin về thời điểm sử dụng các đối tượng này.

Chuỗi này được định dạng là [Dấu thời gian](/cloud/reference/types#timestamp).

Cần có các phạm vi sau đây để ứng dụng OAuth 2.0 của bạn sử dụng điểm cuối này. Để biết thêm thông tin về cách đăng ký ứng dụng OAuth 2.0, hãy xem [Đăng Ký và Đánh Giá Ứng Dụng]({oauth2ReferenceDocLink}).

Không có mô tả nào được cung cấp.

Điều này cho phép bạn xem thông tin về tài sản của mình.

Điều này cho phép bạn tải lên và cập nhật tài sản vào Roblox.

Điều này giúp bạn có thể cấp quyền đối với tài sản cho bất kỳ chủ thể nào (bao gồm nhóm và trải nghiệm) để sử dụng những tài sản mà tài khoản của bạn đang quản lý.

Cấp khả năng cập nhật huy hiệu mà người dùng sở hữu.

Điều này cho phép bạn xem thông tin về vật phẩm thương mại của mình.

Điều này cho phép bạn chỉnh sửa các kết nối người bán thương mại.

Điều này cho phép bạn xem thông tin về các sản phẩm trong Cửa Hàng Nhà Sáng Tạo của bạn.

Điều này cho phép bạn sửa đổi thông tin về các sản phẩm trong Cửa Hàng Nhà Sáng Tạo của bạn.

Điều này cho phép bạn xem thông tin về cộng đồng của mình.

Điều này cho phép bạn quản lý các yêu cầu tham gia cộng đồng và cập nhật vai trò của thành viên cộng đồng bậc thấp cho tài khoản của bạn.

Điều này cho phép bạn xem thông tin về kho của mình.

Cấp quyền quản lý tài sản của người dùng.

Cấp quyền truy cập để quản lý huy hiệu của bạn.

Cấp quyền để quản lý huy hiệu của bạn và chi tiêu robux.

Cấp quyền quản lý các sản phẩm phát triển của bạn.

Cấp quyền đọc thông tin về các trải nghiệm mà bạn đang theo dõi.

Cấp quyền thay mặt bạn theo dõi và bỏ theo dõi các trải nghiệm.

Cấp quyền truy cập để quản lý vé của bạn.

Cấp quyền truy cập để quản lý các cộng đồng của bạn.

Cấp quyền để đọc thông tin cộng đồng.

Cấp quyền để đọc và ghi các bảng bản địa hóa của bạn

Cấp quyền truy cập để quản lý hoạt động cộng tác đội cho tất cả các trải nghiệm của bạn.

Cấp quyền truy cập để quản lý các trải nghiệm của bạn và một số thông tin cụ thể gắn liền với các trải nghiệm đó (ví dụ: thông tin bản địa hóa).

Cấp quyền để đọc thông tin bản địa hóa của các trải nghiệm của bạn.

Cấp quyền để sửa đổi các tùy chọn bản địa hóa trải nghiệm của bạn.

Cấp quyền truy cập để quản lý tài khoản người dùng của bạn.

Cấp quyền để sửa đổi các tùy chọn bản địa hóa của người dùng.

Điều này cho phép bạn đăng tải tin nhắn thay mặt cho người dùng.

Điều này cho phép gửi các thông báo từ trải nghiệm của bạn đến người dùng.

Điều này cho phép bạn liệt kê mã liên quan đến trải nghiệm của bạn.

Điều này cho phép bạn tạo và cập nhật mã liên quan đến trải nghiệm của bạn.

Cấp quyền để đọc về các trang bị đặc quyền của bạn.

Cấp khả năng đọc thông tin địa điểm.

Cấp khả năng chỉnh sửa thông tin địa điểm.

Thao tác này cấp quyền đăng tải các phiên bản mới của trải nghiệm cho Roblox.

Cấp khả năng đọc thông tin trải nghiệm.

Cấp khả năng chỉnh sửa thông tin trải nghiệm.

Cho phép bạn xem các hạn chế của người dùng trong trải nghiệm.

Cho phép bạn chỉnh sửa các hạn chế người dùng trong trải nghiệm.

Cấp khả năng đọc trạng thái premium và trạng thái đã xác thực của người dùng.

Điều này cho phép bạn xem các tài khoản mạng xã hội của người dùng.

Điều này cho phép kích hoạt chức năng Đăng Nhập Một Lần.

Điều này cho phép người dùng đọc thông tin hồ sơ của bạn.

Authentication v1