5️⃣

5. Item Inventory(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 issued through user authentication ※ On the web, the "SUAT cookie value" is used
X-Lang	String	Y	-	ko	Language code
X-Nation	String	Y	-	KR	Country code
X-Timezone	String	Y	-	Asia/Seoul	Timezone
X-Utc-Offset	Int32	Y	-	540	UTC Offset
caller-id	String	Y	-	clientapp	API Caller Information Example: ServiceName_GAME_SERVER

Path Variable

Name	Type	Required	Default Value	Example	Description
service_id	String	Y	-	GAME_ID	Game ID issued by the studio

Paramater (Query String)

Name	Type	Required	Default Value	Example	Description
shop_key	String	Y	-	indie	Sales Channel Key
guid	Int64	Y	-	123456	Character number or unique key within the game • character_no > guid > member_no (transmitted in this order)
ts	Int64	Y	-	1608252682229	timestamp

Response

Body

Name	Type	Required	Default Value	Example	Description
code	Integer	Y	-	0	Response code
message	String	Y	-	OK	Response message
value	Object	N	-		Response value

Value

Name	Type	Required	Default Value	Example	Description
total_count	Int	Y	-	10	Total count
list	Object	Y	-		List

List

Name	Type	Required	Default Value	Example	Description
txn_mst_no	int64	Y	-	5683669676745096842	Order Master Number
txn_dtl_no	int64	Y	-	5683669676745096842	Order Details Number
product_id	Int64	Y	-	1001	Platform-specific item ID
inservice_item_id	String	Y	-	gameid	In-game item ID
product_name	String	Y	-	아이템A	Item Name • Multilingual Support
quantity	Int32	Y	-	1	Purchase quantity
thumbnail_url	String	Y	-	https://	Featured Product Image

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":"Item A",
            "quantity":1,
            "thumbnail_url":"https://"
         },
         {
            "txn_mst_no":4683669676745096843,
            "txn_dtl_no":4626165616690703659,
            "product_id":1002,
            "inservice_item_id":"gameidB",
            "product_name":"Item 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
복사

Response Failure Example

{
  "code": "999999",
  "message": "This is an undefined error."
}
JavaScript
복사

Return Code

HTTP Status code	response_code	response_message	Description
200	0	OK	Success
200	999999	정의되지 않은 오류입니다.	Item Shop API Error
500	500	Internal Server Error	Internal server error