This article provides a guide to retrieving the username information of a user using your game on a game server.
Feature introduction
You can retrieve username information (member_no or guid) from Game Server by member_no and guid.
You must include your API Access Token in the header for this authentication process, and if you don't have an API Access Token, you must go through the API Token issuance process.
기본 정보
GET /member/v3.0/{game_id}
Host: https://api.onstove.com (Live)
Content-Type: application/json
Plain Text
복사
Request
Header
Name | Type | Required | Default Value | Example | Description |
Authorization | String | Y | Bearer | API Access Token | - |
API Access Token issuanceAPI Access tokens are issued through API Access Token issuance.
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) |
The guid in the value is a game-specific ID generated when you agree to the Terms of Service. If you are a STOVE member (member_no) who has not agreed to the Terms of Service, you cannot get the guid 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'
Plain Text
복사
Response
// Examples of successful responses{
"code": 0,
"message": "success",
"value": {
"member_no": 20005061986,
"guid": 200000000397
}
}
JSON
복사
// Invalid parameters{
"code": 40000,
"message": "bad request"
}
JSON
복사
// Invalid game_id{
"code": 41002,
"message": "Invalid game id"
}
JSON
복사
Return Code
HTTP Status code | Code | Message | Description |
200 | 0 | Success | Response success |
200 | 40000 | bad request | Invalid parameters - Missing token passing - Missing query parameters |
200 | 41002 | Invalid game id | Invalid game_id- The gameid in the token is different from the requested gameid. |
401 | 40101 | Invalid game id | If the call was made with an invalid access token |