> ## 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.

# GET (/users/xuid({xuid})/inbox/{messageId})

> GET (/users/xuid({xuid})/inbox/{messageId})

# GET (/users/xuid({xuid})/inbox/{messageId})

특정 사용자 메시지에 대한 자세한 메시지 텍스트를 검색하고, 서비스에서 해당 메시지를 읽은 상태로 표시합니다.
이러한 URI의 도메인은 `msg.xboxlive.com`입니다.

* [설명](#ID4EV)
* [URI 매개 변수](#ID4EEB)
* [권한 부여](#ID4ERB)
* [요청 본문](#ID4E3B)
* [리소스에 대한 개인 정보 설정의 영향](#ID4EJC)
* [HTTP 상태 코드](#ID4EUC)
* [JavaScript Object Notation(JSON) 응답](#ID4EUE)

## 설명

get 작업은 User, System, FriendRequest 메시지 형식에서만 수행할 수 있습니다.

이 URI는 Xbox.com에서 새로 고침이 필요합니다. 현재 XBOX 360에서는 사용자가 로그아웃했다가 다시 로그인할 때까지 읽음/읽지 않음 상태가 업데이트되지 않습니다.

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

## URI 매개 변수

| 매개 변수 | 형식 | 설명 |
| - | - | - |
| xuid | unsigned 64-bit integer | 요청을 수행하는 플레이어의 XBOX User ID(XUID)입니다. |
| messageId | string\[50] | 검색되거나 삭제되는 메시지의 ID입니다. |

## 권한 부여

사용자 메시지를 검색하려면 자신의 사용자 클레임이 있어야 합니다.

## 요청 본문

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

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

자신의 사용자 메시지만 검색할 수 있습니다.

## HTTP 상태 코드

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

\| 코드| 설명|
\| --- | --- | --- | --- | --- |
\| 200| 성공.|
\| 400| XUID를 제대로 변환할 수 없습니다.|
\| 403| XUID를 변환할 수 없거나 유효한 XUID 클레임을 찾을 수 없습니다.|
\| 404| 유효한 XUID가 없거나 메시지 ID를 찾을 수 없거나 잘못 구문 분석되었습니다.|
\| 500| 일반 서버 측 오류이거나 메시지 형식이 GET에 유효하지 않습니다.|

## JavaScript Object Notation(JSON) 응답

호출이 성공하면 서비스가 결과 데이터를 JSON 형식으로 반환합니다. 루트 개체는 UserMessageHeader 개체입니다.

#### UserMessageHeader

| 속성 | 형식 | 최대 길이 | 설명 |
| - | - | - | - |
| header | Header | | JSON 개체 |
| messageText | string | 256 | UTF-8 |

#### Header

| 속성 | 형식 | 최대 길이 | 설명 |
| - | - | - | - |
| sent | DateTime | | 메시지를 보낸 날짜와 시간입니다. (서비스에서 제공됩니다.) |
| expiration | DateTime | | 메시지가 만료되는 날짜와 시간입니다. (모든 메시지에는 최대 수명이 있으며, 이는 이후에 결정됩니다.) |
| messageType | string | 13 | 메시지 형식: User, System, FriendRequest. |
| senderXuid | ulong | | 보낸 사람의 XUID입니다. |
| sender | string | 15 | 보낸 사람의 게이머태그입니다. |
| hasAudio | bool | | 메시지에 오디오(음성) 첨부 파일이 있는지 여부입니다. |
| hasPhoto | bool | | 메시지에 사진 첨부 파일이 있는지 여부입니다. |
| hasText | bool | | 메시지에 텍스트가 포함되는지 여부입니다. |

#### 샘플 응답

```cpp theme={null}
{
          "header":
          {
            "expiration":"2011-10-11T23:59:59.9999999",
            "messageType":"User",
            "senderXuid":"123456789",
            "sender":"Striker",
            "sent":"2011-05-08T17:30:00Z",
            "hasAudio":false,
            "hasPhoto":false,
            "hasText":true
          },
        "messageText":"random user text up to 256 characters"
        }

```

#### 오류 응답

오류가 발생한 경우 서비스는 errorResponse 개체를 반환할 수 있으며, 여기에는 서비스 환경의 값이 포함될 수 있습니다.

\| 속성| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| errorSource| string| 오류가 발생한 위치를 나타냅니다.|
\| errorCode| int| 오류와 연결된 숫자 코드입니다(null일 수 있음).|
\| errorMessage| string| 세부 정보를 표시하도록 구성된 경우 오류의 세부 정보입니다.|

## 참고 항목

##### 상위

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

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


## Related topics

- [XblAchievementsGetAchievementsForTitleIdAsync](https://devdocs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)