1. Basic information
GET /ownership/v3.0/check_ownership
Host:
https://api.onstove.com (Live)
Content-Type: application/json
2. Request format
Header
Content-Type | String | Y | Contents-Type ex : application/json |
authorization | String | Y | Authentication session, the session key (Game Server Token) issued as part of the Server OAuth authentication process. |
caller-id | String | Y | Calling application name(ex : ownership-api) |
Body
member_no | Long | Y | Member Unique NO ex) Platform Member member_no |
game_ids | String | Y | List of GameIDs (passed in separated by , , and ) |
3. Response format
Response Body Value
member_no | Long | Member Unique NO ex) Platform Member member_no |
owner_list | Obejct Array | See below |
game_id | String | Owning Game ID |
game_cd | Integer | 게임구분
3:Main Game
4:Demo Games
5:DLC |
ownership_cd | Integer | Ownership Classification
1:Acquisition of Ownership
2:Release of ownership |
purchase_dt | Long | Purchase Date (timestamp) |
product_no | Long | Store productNo |
Sample code
Request Example
1234 | curl --location 'http://api-{env}.onstove.com/ownership/v3.0/check_ownership?game_ids=DEMO_150&member_no=1234' \--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHBpcmVfdGltZSI6MTcwNDkzNjQxNTIzMSwibWVtYmVyX25vIjoxMDAwMDAwMDE3NTAsImFwcGxpY2F0aW9uX25vIjoxMDAwMn0.llanAiKn7TD1Z__coIGYtMYxR4Rh9q0DnT-LpyKZtkCR0Q2e2iHX6oQxkbHGG0g-Jn5sPg7wgt3MrOBRkZsyKm4pkq2qNjQMvSFmenpj-652wWiW_Ybl6uJkHjPkrp4G0K2BFMqoytj6MfFfC-ruKkE9gUod0AzRP3aOeiLapuH3MsPyVy80QsAR81Wnn4cMRRISReug7FPxGV8tMqcMk6aw7i0acr_gxQuzyRxow70_nMz_h99dIR9D54CVJaOZcBO8XPw5KKXoVyblnoKdSzIJhCpv1ibRjwxJZjKlBGc' \--header 'caller-id: APPLICATION NAME' \--header 'Content-Type: application/json' |
Response Example
Content-Type : application/json
12345678910111213141516 | { "response_code": 0, "response_message": "success", "value" : { "member_no" : 1004, "owner_list" : [ { "game_id" : "STOVE_TEST1", "game_cd" : 3, "ownership_cd" : 1, "purchase_dt" : 1529422815400, "product_no" : 123 } ] }} |
Response Code
0 | Normal |
500 | Raising an exception |
502 | You entered an invalid parameter. |