다음을 통해 공유

POST (/users/xuid({xuid})/outbox)

  • 아티클

지정한 메시지를 받는 사람 목록에 보냅니다. 이 URI의 도메인은 msg.xboxlive.com입니다.

설명

이 API가 지원하는 유일한 콘텐츠 유형은 각 호출의 HTTP 헤더에 필요한 "application/json"입니다.

URI 매개 변수

매개 변수 형식 설명
xuid 부호 없는 64비트 정수 요청하는 플레이어의 Xbox 사용자 ID(XUID)입니다.

Authorization

사용자 메시지를 보내려면 자체 사용자 클레임과 유효한 골드 멤버십이 있어야 합니다.

리소스에 대한 개인 정보 설정의 영향

해당 플레이어가 친구인지 여부에 관계없이 사용자 메시지를 플레이어에게 성공적으로 보내면 결과 코드 200이 표시됩니다. 하지만 사용자를 차단한 사람에게 메시지를 보내면 받는 사람은 메시지를 받지 못하며 메시지가 성공적이지 않은 것을 나타내는 표시도 제공되지 않습니다.

다음과 같이 하루에 보낼 수 있는 메시지 수와 친구 및 친구가 아닌 사람에게 보낼 수 있는 메시지 수에 대한 제한도 있습니다.

  • 메시지당 모르는 사람 20명
  • 24시간당 모르는 사람 200명
  • 24시간당 메시지 총 250개
  • 24시간당 받는 사람 총 2500명
요청 사용자 대상 사용자의 개인 정보 설정 동작
나 - 설명과 같습니다.
친구 모두 200 OK
친구 친구만 200 OK
친구 차단 200 OK
친구가 아닌 사용자 모두 200 OK
친구가 아닌 사용자 친구만 200 OK
친구가 아닌 사용자 차단 200 OK
타사 사이트 모두 200 OK
타사 사이트 친구만 200 OK
타사 사이트 차단 200 OK

요청 본문

속성 유형 최대 길이 사용자 비고
헤더 헤더 모두 사용자 메시지 헤더
messageText 문자열 250 Windows 8을 제외한 모든 플랫폼 사용자 메시지 텍스트(UTF-8)
속성 유형 최대 길이 사용자 비고
recipients User[] 20 모두 메시지 받는 사람 목록

사용자

속성 유형 최대 길이 사용자 비고
xuid ulong 모두 받는 사람 XUID. 게이머태그가 전송되는 경우 사용되지 않습니다.
gamertag 문자열 15 모두 받는 사람의 게이머태그. XUID가 전송되는 경우 사용되지 않습니다.

샘플 요청 본문

{
          "header":
          {
            "recipients":
            [{"gamertag":"GoTeamEmily"},
            {"gamertag":"Longstreet360"}]
          },
          "messageText":"random user text"
        }

HTTP 상태 코드

서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요.

코드 설명
200 성공.
400 받는 사람 목록이 비어 있거나 최대 길이를 초과합니다. 또는 게이머태그와 XUID가 모두 지정되었습니다. 또는 messageText가 너무 깁니다.
403 XUID는 변환될 수 없습니다.
404 게이머태그가 유효하지 않거나 사용자를 찾을 수 없습니다.
409 사용자가 시스템에서 지정한 일일 한도에 도달했습니다.
500 일반적인 서버 측 오류.

응답 본문

이 응답의 본문에는 개체가 전송되지 않습니다.

참고 항목

부모

/users/xuid({xuid})/outbox

표준 HTTP 상태 코드 참조