DELETE (/users/xuid({xuid})/inbox/{messageId})
사용자의 받은 편지함에서 사용자 메시지를 삭제합니다.
이 URI의 도메인은 msg.xboxlive.com입니다.
- 비고
- URI 매개 변수
- Authorization
- 요청 본문
- HTTP 상태 코드
- JSON(JavaScript Object Notation) 응답
- 리소스에 대한 개인 정보 설정의 영향
설명
삭제 작업은 idempotent입니다.
이 API가 지원하는 유일한 콘텐츠 유형은 각 호출의 HTTP 헤더에 필요한 "application/json"입니다.
URI 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| xuid | 부호 없는 64비트 정수 | 요청하는 플레이어의 Xbox 사용자 ID(XUID)입니다. |
| messageId | string[50] | 검색 또는 삭제 중인 메시지의 ID입니다. |
Authorization
사용자 메시지를 삭제하려면 사용자 소유의 클레임이 있어야 합니다.
요청 본문
이 요청의 본문에는 개체가 전송되지 않습니다.
HTTP 상태 코드
서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요.
| 코드 | 설명 |
|---|---|
| 204 | 성공. |
| 403 | XUID를 변환할 수 없거나 유효한 XUID 클레임을 찾을 수 없습니다. |
| 404 | URI의 메시지 ID를 구문 분석할 수 없거나 XUID가 URI에 없습니다. |
| 500 | 일반적인 서버 측 오류. |
JSON(JavaScript Object Notation) 응답
오류가 발생할 경우 서비스는 서비스 환경의 값을 포함할 수 있는 errorResponse 개체를 반환할 수 있습니다.
| 속성 | 유형 | 설명 |
|---|---|---|
| errorSource | 문자열 | 오류의 출처를 나타냅니다. |
| errorCode | 정수 | 오류와 관련이 있는 숫자 코드(null일 수 있음). |
| errorMessage | 문자열 | 세부 정보를 표시하도록 구성된 경우 오류에 대한 세부 정보입니다. |
리소스에 대한 개인 정보 설정의 영향
자체 사용자 메시지만 삭제할 수 있습니다.