> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

* [설명](#ID4EV)
* [URI 매개 변수](#ID4EAB)
* [권한 부여](#ID4ENB)
* [리소스에 대한 개인 정보 설정의 영향](#ID4EYB)
* [요청 본문](#ID4E3F)
* [HTTP 상태 코드](#ID4ETCAC)
* [응답 본문](#ID4E1EAC)

## 설명

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

## URI 매개 변수

| 매개 변수 | 형식 | 설명 |
| - | - | - |
| xuid | unsigned 64-bit integer | 요청을 수행하는 플레이어의 XBOX User ID(XUID)입니다. |

## 권한 부여

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

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

플레이어에게 사용자 메시지를 성공적으로 보내면 그 플레이어가 친구든 아니든 결과 코드 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|

## 요청 본문

| 속성 | 형식 | 최대 길이 | Consumers | 설명 |
| - | - | - | - | - |
| header | Header | | All | 사용자 메시지 헤더 |
| messageText | string | 250 | Windows 8을 제외한 모든 플랫폼 | 사용자 메시지 텍스트(UTF-8) |

#### Header

| 속성 | 형식 | 최대 길이 | Consumers | 설명 |
| - | - | - | - | - |
| recipients | User\[] | 20 | All | 메시지 수신자 목록 |

#### User

| 속성 | 형식 | 최대 길이 | Consumers | 설명 |
| - | - | - | - | - |
| xuid | ulong | | All | 수신자의 XUID입니다. gamertag이 전송되면 사용되지 않습니다. |
| gamertag | string | 15 | All | 수신자의 게이머태그입니다. XUID가 전송되면 사용되지 않습니다. |

#### 샘플 요청 본문

```cpp theme={null}
{
          "header":
          {
            "recipients":
            [{"gamertag":"GoTeamEmily"},
            {"gamertag":"Longstreet360"}]
          },
          "messageText":"random user text"
        }

```

## HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 [Standard HTTP status codes](https://devdocs.xbox.com/ko/reference/live/rest/additional/httpstatuscodes)를 참고하십시오.

\| 코드| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| 성공.|
\| 400| 수신자 목록이 비어 있거나 최대 길이를 초과합니다. 또는 gamertag과 XUID가 모두 지정되었습니다. 또는 messageText가 너무 깁니다.|
\| 403| XUID를 변환할 수 없습니다.|
\| 404| 게이머태그가 잘못되었거나 사용자를 찾을 수 없습니다.|
\| 409| 사용자가 시스템에서 부과한 일일 한도에 도달했습니다.|
\| 500| 일반 서버 측 오류입니다.|

## 응답 본문

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

## 참고 항목

##### 상위

[/users/xuid({xuid})/outbox](https://devdocs.xbox.com/ko/reference/live/rest/uri/users/uri-usersxuidoutbox)

##### 참조  [Standard HTTP status codes](https://devdocs.xbox.com/ko/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblSocialSubmitReputationFeedbackAsync](https://devdocs.xbox.com/fr-CA/reference/live/xsapi-c/social_c/functions/xblsocialsubmitreputationfeedbackasync.md)
- [XblAchievementsManagerUpdateAchievement](https://devdocs.xbox.com/es/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)