Skip to main content

POST ()

소비성 인벤토리 항목의 전부 또는 일부가 사용되었음을 나타내고, 요청된 수량만큼 소비성 항목의 수량을 감소시킵니다. 이 URI의 도메인은 inventory.xboxlive.com입니다.

설명

  • 호출자가 소비하기를 요청한 수량이 항목의 남은 공급량을 초과하면 호출은 거부됩니다.
  • 호출자가 소비하기를 요청한 수량은 0보다 큰 양의 정수여야 합니다. 소비 값이 0 이하인 호출은 거부됩니다.
  • 호출자가 빈 Transaction ID를 제공하면 요청은 거부됩니다.
  • 사용 가능한 경우 어떤 타이틀이 소비를 보고하는지 확인할 수 있도록 title claim이 기록됩니다.
  • 동일한 transactionId로 이루어진 추가 POST는 일정 시간 동안 무시됩니다.
참고:
이 API의 x-xbl-contract-version 헤더는 “4”입니다.

URI 매개변수

| 매개변수| 형식| 설명| | --- | --- | --- | --- | | itemID| string| 단일 인벤토리 항목에 대해 사용자별로 고유한 ID입니다.|

요청 본문

샘플 요청

remove quantity 필드는 호출자가 소비성 항목의 남은 수량에서 제거하고자 하는 소비성 항목의 수량을 나타낼 수 있게 합니다. Transaction ID 필드는 동일한 사용을 두 번 계산할 위험을 줄이면서 소비성 콘텐츠 작업을 사용하여 재시도할 수 있는 수단을 호출자에게 제공합니다.

응답 본문

인증을 통과하고 적절한 권한 부여 컨텍스트가 할당되었다는 가정 하에, POST에 대한 응답은 POST 요청에서 서비스로 전달된 것과 동일한 transactionId, 소비성 항목의 URL 및 항목의 새로운 수량 값과 함께 수신 확인을 제공합니다.

샘플 응답

참고 항목

상위 항목
/users/me/consumables/
추가 정보
EDS Common Headers EDS Parameters EDS Query Refiners Marketplace URIs 추가 참조
Last modified on October 19, 2026