Skip to main content

GET (/users/xuid()/inbox/)

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

설명

get 작업은 User, System, FriendRequest 메시지 형식에서만 수행할 수 있습니다. 이 URI는 Xbox.com에서 새로 고침이 필요합니다. 현재 XBOX 360에서는 사용자가 로그아웃했다가 다시 로그인할 때까지 읽음/읽지 않음 상태가 업데이트되지 않습니다. 이 API가 지원하는 유일한 콘텐츠 형식은 “application/json”이며, 모든 호출의 HTTP 헤더에서 필수입니다.

URI 매개 변수

권한 부여

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

요청 본문

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

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

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

HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 Standard HTTP status codes를 참고하십시오. | 코드| 설명| | --- | --- | --- | --- | --- | | 200| 성공.| | 400| XUID를 제대로 변환할 수 없습니다.| | 403| XUID를 변환할 수 없거나 유효한 XUID 클레임을 찾을 수 없습니다.| | 404| 유효한 XUID가 없거나 메시지 ID를 찾을 수 없거나 잘못 구문 분석되었습니다.| | 500| 일반 서버 측 오류이거나 메시지 형식이 GET에 유효하지 않습니다.|

JavaScript Object Notation(JSON) 응답

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

UserMessageHeader

샘플 응답

오류 응답

오류가 발생한 경우 서비스는 errorResponse 개체를 반환할 수 있으며, 여기에는 서비스 환경의 값이 포함될 수 있습니다. | 속성| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | errorSource| string| 오류가 발생한 위치를 나타냅니다.| | errorCode| int| 오류와 연결된 숫자 코드입니다(null일 수 있음).| | errorMessage| string| 세부 정보를 표시하도록 구성된 경우 오류의 세부 정보입니다.|

참고 항목

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