Xbox Live 사용자 관리

  • 아티클

요청

콘솔에서 사용자 목록을 불러오거나 기존 사용자 추가, 제거, 로그인, 로그아웃 또는 수정과 같은 목록을 업데이트할 수 있습니다.

메서드 요청 URI
GET /ext/user
PUT /ext/user

URI 매개 변수

  • 아니요

요청 헤더

  • 아니요

요청 본문

PUT 호출에는 다음 구조의 JSON 배열이 포함되어야 합니다.

  • 사용자
    • AutoSignIn(선택 사항) : EmailAddress 또는 UserId로 지정된 계정에 대해 자동 로그인을 사용하지 않도록 설정하거나 사용하도록 설정하는 부울입니다.
    • EmailAddress(선택 사항 - 스폰서 사용자에 로그인하지 않는 한 UserId가 제공되지 않은 경우에 제공되어야 합니다.) : 수정/추가/삭제할 사용자를 지정하는 전자 메일 주소입니다.
    • 암호(선택 사항 - 사용자가 현재 콘솔에 없는 경우에 제공해야 합니다.) : 콘솔에 새 사용자를 추가하는 데 사용되는 암호입니다.
    • SignedIn(선택 사항) : 제공된 계정의 로그인 또는 로그아웃 여부를 지정하는 부울입니다.
    • UserId(선택 사항 - 스폰서 사용자에 로그인하지 않는 한 EmailAddress가 제공되지 않은 경우에 제공되어야 합니다.) : 수정/추가/삭제할 사용자를 지정하는 UserId입니다.
    • SponsoredUser(선택 사항) : 스폰서 사용자를 추가할지 여부를 지정하는 부울입니다.
    • 삭제(선택 사항): 콘솔에서 이 사용자를 삭제하도록 지정하는 부울

응답

응답 본문

GET에 대한 호출은 다음 속성을 통해 JSON 배열을 반환합니다.

  • 사용자
    • AutoSignIn(선택 사항)
    • EmailAddress(선택 사항)
    • Gamertag
    • SignedIn
    • UserId
    • XboxUserId
    • SponsoredUser(선택 사항)

상태 코드

이 API에서 예상되는 상태 코드는 다음과 같습니다.

HTTP 상태 코드 설명
200 GET 호출에 성공했고 응답 본문에 반환된 사용자의 JSON 배열
204 PUT 호출에 성공했으며 콘솔의 사용자가 업데이트되었습니다.
4XX 잘못된 요청 데이터 또는 형식에 대한 다양한 오류
5XX 예기치 않은 오류에 대한 오류 코드