Xbox Live 사용자 관리Xbox Live User Management

요청Request

콘솔에서 사용자 목록을 가져오거나, 기존 사용자를 추가, 제거, 로그인, 로그 아웃 또는 수정할 수 있습니다.You can get the list of users on the console, or update the list--adding, removing, signing in, signing out, or modifying existing users.

방법Method 요청 URIRequest URI
GETGET /ext/user/ext/user
PUTPUT /ext/user/ext/user

URI 매개 변수URI parameters

  • 없음None

요청 헤더Request headers

  • 없음None

요청 본문Request body

PUT에 대 한 호출은 다음 구조의 JSON 배열을 포함 해야 합니다.Calls to PUT should include a JSON array with the following structure:

  • 사용자Users
    • AutoSignIn (선택 사항): EmailAddress 또는 UserId로 지정 된 계정에 대해 자동 로그인을 사용 하지 않거나 사용 하도록 설정 합니다.AutoSignIn (optional) : bool disabling or enabling automatic signin for the account specified by EmailAddress or UserId.
    • EmailAddress (선택 사항-사용자에 게 로그인 하지 않는 경우 UserId가 제공 되지 않으면 제공 되어야 함): 수정/추가/삭제할 사용자를 지정 하는 전자 메일 주소입니다.EmailAddress (optional - must be provided if UserId is not provided unless signing in a sponsored user) : Email address specifying the user to modify/add/delete.
    • 암호 (선택 사항)-콘솔에 새 사용자를 추가 하는 데 사용 되는 암호 (선택 사항): 암호를 입력 해야 합니다.Password (optional - must be provided if the user isn't currently on the console) : Password used for adding a new user to the console.
    • (선택 사항): 제공 된 계정에 로그인 또는 로그 아웃 해야 하는지 여부를 지정 하는 부울입니다.SignedIn (optional) : bool specifying whether the provided account should be signed in or out.
    • UserId (선택 사항-후원 된 사용자에 게 로그인 하지 않는 경우 EmailAddress를 제공 하지 않으면 제공 해야 함): 수정/추가/삭제할 사용자를 지정 하는 UserId입니다.UserId (optional - must be provided if EmailAddress is not provided unless signing in a sponsored user) : UserId specifying the user to modify/add/delete.
    • SponsoredUser (선택 사항): 후원 사용자를 추가할지 여부를 지정 하는 부울입니다.SponsoredUser (optional) : bool specifying whether to add a sponsored user.
    • Delete (선택 사항): 콘솔에서이 사용자를 삭제 하도록 지정 하는 부울Delete (optional) : bool specifying to delete this user from the console

응답Response

응답 본문Response body

GET을 호출 하면 다음 속성을 사용 하 여 JSON 배열을 반환 합니다.Calls to GET will return a JSON array with the following properties:

  • 사용자Users
    • AutoSignIn (선택 사항)AutoSignIn (optional)
    • EmailAddress (선택 사항)EmailAddress (optional)
    • 게이머 태그Gamertag
    • 이상SignedIn
    • UserIdUserId
    • XboxUserIdXboxUserId
    • SponsoredUser (선택 사항)SponsoredUser (optional)

상태 코드Status code

이 API는 다음과 같은 예상 상태 코드를 포함 합니다.This API has the following expected status codes.

HTTP 상태 코드HTTP status code DescriptionDescription
200200 성공적으로 GET을 호출 하 고 응답 본문에서 반환 된 사용자의 JSON 배열을 반환 합니다.Call to GET was successful and JSON array of users returned in the response body
204204 PUT을 호출 하 고 콘솔의 사용자를 업데이트 했습니다.Call to PUT was successful and the users on the console have been updated
4XX4XX 잘못 된 요청 데이터 또는 형식에 대 한 다양 한 오류Various errors for invalid request data or format
5XX5XX 예기치 않은 오류에 대 한 오류 코드Error codes for unexpected failures