Skip to main content

POST (/users/xuid()/outbox)

지정된 메시지를 수신자 목록에 보냅니다. 이러한 URI의 도메인은 msg.xboxlive.com입니다.

설명

이 API가 지원하는 유일한 콘텐츠 형식은 “application/json”이며, 모든 호출의 HTTP 헤더에서 필수입니다.

URI 매개 변수

권한 부여

사용자 메시지를 보내려면 자신의 사용자 클레임과 유효한 골드 구독이 있어야 합니다.

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

플레이어에게 사용자 메시지를 성공적으로 보내면 그 플레이어가 친구든 아니든 결과 코드 200이 반환됩니다. 그러나 자신을 차단한 사용자에게 메시지를 보낸 경우, 수신자는 메시지를 받지 못하며 메시지가 성공하지 못했다는 표시를 받지 못합니다. 또한 하루에 보낼 수 있는 메시지의 수와 친구 및 친구가 아닌 사람에게 보낼 수 있는 메시지의 수에 다음과 같은 제한이 있습니다.
  • 메시지당 낯선 사람 20명
  • 24시간당 낯선 사람 200명
  • 24시간당 총 메시지 250개
  • 24시간당 총 수신자 2500명
| 요청 사용자| 대상 사용자의 개인 정보 설정| 동작| | --- | --- | --- | --- | --- | --- | | me| -| 설명된 대로.| | friend| everyone| 200 OK| | friend| friends only| 200 OK| | friend| blocked| 200 OK| | non-friend user| everyone| 200 OK| | non-friend user| friends only| 200 OK| | non-friend user| blocked| 200 OK| | third-party site| everyone| 200 OK| | third-party site| friends only| 200 OK| | third-party site| blocked| 200 OK|

요청 본문

User

샘플 요청 본문

HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 Standard HTTP status codes를 참고하십시오. | 코드| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| 성공.| | 400| 수신자 목록이 비어 있거나 최대 길이를 초과합니다. 또는 gamertag과 XUID가 모두 지정되었습니다. 또는 messageText가 너무 깁니다.| | 403| XUID를 변환할 수 없습니다.| | 404| 게이머태그가 잘못되었거나 사용자를 찾을 수 없습니다.| | 409| 사용자가 시스템에서 부과한 일일 한도에 도달했습니다.| | 500| 일반 서버 측 오류입니다.|

응답 본문

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

참고 항목

상위
/users/xuid()/outbox
참조 Standard HTTP status codes
Last modified on October 19, 2026