5️⃣

5. 아이템 인벤토리(web)

구매했던 모든 아이템 목록 내역을 조회할 수 있습니다.

기본정보

GET /bill-store/v1.0/{{service_id}}/product/inventory/web
Host:
   https://api.onstove.com (LIVE)    
   https://api.gate8.com (SB)
Content-Type: application/json
JavaScript
복사

Request

Header

Name	Type	Required	Default Value	Example	Description
authorization	String	Y	-	{access_token}	사용자의 인증을 통해 발급 되는 access token ※ Web에서는 “SUAT 쿠키값” 사용
X-Lang	String	Y	-	ko	언어 코드
X-Nation	String	Y	-	KR	국가 코드
X-Timezone	String	Y	-	Asia/Seoul	Timezone
X-Utc-Offset	Int32	Y	-	540	UTC Offset
caller-id	String	Y	-	clientapp	API 호출자 정보 예) 서비스명_GAME_SERVER

Path Variable

Name	Type	Required	Default Value	Example	Description
service_id	String	Y	-	GAME_ID	스튜디오에서 발급된 게임ID

Paramater (Query String)

Name	Type	Required	Default Value	Example	Description
shop_key	String	Y	-	indie	판매 채널 키
guid	Int64	Y	-	123456	캐릭터 번호 또는 game 내 unique key • character_no > guid > member_no (해당 순서로 전달)
ts	Int64	Y	-	1608252682229	timestamp

Response

Body

Name	Type	Required	Default Value	Example	Description
code	Integer	Y	-	0	응답 코드
message	String	Y	-	OK	응답 메시지
value	Object	N	-		응답 값

Value

Name	Type	Required	Default Value	Example	Description
total_count	Int	Y	-	10	총 카운트
list	Object	Y	-		리스트

List

Name	Type	Required	Default Value	Example	Description
txn_mst_no	int64	Y	-	5683669676745096842	주문 마스터 번호
txn_dtl_no	int64	Y	-	5683669676745096842	주문 상세 번호
product_id	Int64	Y	-	1001	플랫폼 고유 아이템 ID
inservice_item_id	String	Y	-	gameid	게임 내 아이템ID
product_name	String	Y	-	아이템A	아이템 명 • 다국어 지원
quantity	Int32	Y	-	1	구매 수량
thumbnail_url	String	Y	-	https://	대표 상품 이미지

Sample

Request

curl --location --request GET'https://api.onstove.com/bill-store/v1.0/{{service_id}}/product/inventory/web?shop_key=indie&character_no=1234&product_type_code=1' \
--header 'Authorization: Bearer {{access_token}}'
--header 'X-Lang: ko'
--header 'X-Nation: KR'
--header 'X-Timezone: Asia/Seoul'
--header 'X-Utc-Offset: 540'
--header 'caller-id: {{caller-id}}'
JavaScript
복사

Response

Content-Type : application/json

{
   "value":{
      "total_count":3,
      "list":[
         {
            "txn_mst_no":4683669676745096843,
            "txn_dtl_no":5683669676745096842,
            "product_id":1001,
            "inservice_item_id":"gameidA",
            "product_name":"아이템A",
            "quantity":1,
            "thumbnail_url":"https://"
         },
         {
            "txn_mst_no":4683669676745096843,
            "txn_dtl_no":4626165616690703659,
            "product_id":1002,
            "inservice_item_id":"gameidB",
            "product_name":"아이템B",
            "quantity":2,
            "thumbnail_url":"https://"
         },
         {
            "txn_mst_no":5418803205289636104,
            "txn_dtl_no":4793931263607167629,
            "product_id":1883,
            "inservice_item_id":"TPC_cp_item_03",
            "product_name":"TPC_cp_item_03",
            "quantity":2,
            "thumbnail_url":"https://"
         }
      ]
   },
   "code":0,
   "message":"OK"
}
JavaScript
복사

응답 실패 예제

{
  "code": "999999",
  "message": "정의되지 않은 오류입니다."
}
JavaScript
복사

Return Code

HTTP Status code	response_code	response_message	Description
200	0	OK	성공
200	999999	정의되지 않은 오류입니다.	아이템 샵 API 오류
500	500	Internal Server Error	서버 내부 오류