POST (/users//people/xuids)

호출자의 people 컬렉션에서 XUID로 people을 가져옵니다. 이러한 URI의 도메인은 social.xboxlive.com입니다.

설명
URI 매개 변수
권한 부여
필수 요청 헤더
선택적 요청 헤더
요청 본문
HTTP 상태 코드
필수 응답 헤더
응답 본문

설명

POST 작업은 리소스를 수정하지 않으므로, 한 번 실행하든 여러 번 실행하든 동일한 결과를 생성합니다.

URI 매개 변수

매개 변수	형식	설명
ownerId	string	리소스에 액세스하는 사용자의 식별자입니다. 인증된 사용자와 일치해야 합니다. 가능한 값은 “me”, xuid() 또는 gt()입니다.

권한 부여

| 형식| 필수| 설명| 누락 시 응답| | --- | --- | --- | --- | --- | --- | --- | | XUID| 예| 호출자에게 사용자의 XBOX User ID(XUID)가 있습니다.| 401 Unauthorized|

필수 요청 헤더

| 헤더| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| String. XBOX LIVE에 대한 권한 부여 데이터입니다. 이는 일반적으로 암호화된 XSTS 토큰입니다. 예시 값: XBL3.0 x=<userhash>;<token>.| | Content-Length| 32-bit unsigned integer. 요청 본문의 길이(바이트)입니다. 예시 값: 22.| | Content-Type| String. 요청 본문의 MIME 형식입니다. 이는 application/json이어야 합니다.|

선택적 요청 헤더

| 헤더| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.| | Accept| String. 호출자가 응답에서 허용하는 Content-Types입니다. 모든 응답은 application/json입니다.|

요청 본문

필수 멤버

| 멤버| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | XuidList| 호출자의 people 컬렉션에서 반환할 people을 식별하는 XUID의 배열입니다. XuidList (JSON)을 참고하십시오.|

선택적 멤버

이 요청에는 선택적 멤버가 없습니다.

금지된 멤버

요청에서 그 외 모든 멤버는 금지됩니다.

샘플 요청

{
    "xuids": [
        "2533274790395904", 
        "2533274792986770", 
        "2533274794866999"
    ]
}
      

HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 Standard HTTP status codes를 참고하십시오. | 코드| Reason phrase| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 메서드가 “get”일 때의 성공.| | 204| No Content| 메서드가 “add” 또는 “remove”일 때의 성공.| | 400| Bad Request| 메서드 매개 변수가 누락되었거나 잘못된 형식이거나 사용자 ID가 잘못된 형식입니다.| | 403| Forbidden| authorization 헤더에서 XUID 클레임을 구문 분석할 수 없습니다.|

필수 응답 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length| 32-bit unsigned integer| 응답 본문의 길이(바이트)입니다. 예시 값: 22.| | Content-Type| string| 응답 본문의 MIME 형식입니다. 이는 항상 application/json입니다.|

응답 본문

응답 본문은 요청 메서드가 “get”일 때만 전송됩니다. “add” 또는 “remove”에는 응답 본문이 없습니다. “get” 메서드 호출이 성공하면 서비스는 호출자의 people 컬렉션에 있는 people의 총 수와 호출자의 people 컬렉션을 포함하는 배열을 반환합니다. “add” 및 “remove” 메서드에는 응답이 반환되지 않습니다. PeopleList (JSON)을 참고하십시오.

샘플 응답

{
    "people": [
        {
            "xuid": "2603643534573573",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573572",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573577",
            "isFavorite": false,
            "isFollowingCaller": false
        },
    ],
    "totalCount": 3
}
         

참고 항목

상위

/users//people/xuids

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

POST (/users/{ownerId}/people/xuids)

POST (/users//people/xuids)

설명

URI 매개 변수

권한 부여

필수 요청 헤더

선택적 요청 헤더

요청 본문

필수 멤버

선택적 멤버

금지된 멤버

샘플 요청

HTTP 상태 코드

필수 응답 헤더

응답 본문

샘플 응답

참고 항목

상위

​POST (/users//people/xuids)

​설명

​URI 매개 변수

​권한 부여

​필수 요청 헤더

​선택적 요청 헤더

​요청 본문

​필수 멤버

​선택적 멤버

​금지된 멤버

​샘플 요청

​HTTP 상태 코드

​필수 응답 헤더

​응답 본문

​샘플 응답

​참고 항목

상위

POST (/users//people/xuids)

설명

URI 매개 변수

권한 부여

필수 요청 헤더

선택적 요청 헤더

요청 본문

필수 멤버

선택적 멤버

금지된 멤버

샘플 요청

HTTP 상태 코드

필수 응답 헤더

응답 본문

샘플 응답

참고 항목