Get game user ID (for servers)

Introduction.

* You can retrieve user ID information (member_no and guid) by member_no or guid from the game server.
  - For this authentication process, you must include the API Access Token in the header, and if you do not have an API Access Token, you must go through the API Token issuance process.

Basic information

GET /member/v3.0/{game_id}
Host: https://api.onstove.com (Live)
      https://api.gate8.com (Sandbox)
Content-Type: application/json

Request

Header

Name	Type	Required	Default Value	Example	Description
Authorization	String	Y	Bearer {api_access_token}	API Access Token

Issue API Access Token

API Access token is issued through API Access Token Issuance - see link page.

Parameter (Query String)

Name	Type	Required	Default Value	Example	Description
search_type	String	Y		MEMBER_NO	Type member_no / guid
value	String	Y		12345678

Response

Body

Name	Type	Required	Default Value	Example	Description
code	int	Y		0	Response code
message	String	Y		success	Response message
value	Object	N			Response value

value

Name	Type	Required	Default Value	Example	Description
member_no	String	Y		108131345	member_no :Platform Unique ID
guid	String	N		20000025262	guid : Game Unique ID

value's guid

guid is a game-specific ID generated when you accept the Terms of Service. If member_no has not agreed to the Terms of Service, guid cannot be returned as a response value.

Sample

Request

curl -L -X GET 'https://api.onstove.com/member/v3.0/MVP_SDK_QA?search_type=member_no&value=20005061986' \
-H 'Authorization: Bearer Es_ulMUjO7OHmk8WfiPE0-zQAppdPEyye6rRRmrZKkw3sdN38bTYANAsco_0kOHc4EPNPGQHKzV4B080JLd1smLs7YkFwpDOwEKi0aqX_qOa7_LVTl-9jvrWfiYQ-XqiUu7HGScjAWth0_K_CXwsdnvogSf3yE3oRSUvD66obgg'

Response

Code type : application/json

{
    "code": 0,
    "message": "success",
    "value": {
        "member_no": 20005061986,
        "guid": 200000000397
    }
}

Invalid parameters

{
    "code": 40000,
    "message": "bad request"
}

Invalid game_id

{
  "code": 41002,
  "message": "Invalid game id"
}

Return Code

HTTP Status code	Code	Message	Description
200	0	Success	Response success
200	40000	bad request	Bad parameter - Missing token transmission - Missing query parameter
200	41002	Invalid game id	Invalid game_id - When the game id in the token and the requested game id are different
401	40101	Invalid game id	When called with an invalid Access Token