소개
•
Game Server에서 member_no 또는 guid로 사용자 아이디 정보(member_no와 guid)를 조회할 수 있습니다.
•
본 인증과정에서 API Access Token을 Header에 포함시켜야 하며, API Access Token이 없는 경우, API Token 발급 과정을 거처야합니다.
기본정보
GET /member/v3.0/{game_id}
Host: https://api.onstove.com (Live)
https://api.gate8.com (Sandbox)
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 발급
Parameter (Query String)
Name | Type | Required | Default Value | Example | Description |
search_type | String | Y | MEMBER_NO | ||
value | String | Y | 12345678 |
Response
Body
Name | Type | Required | Default Value | Example | Description |
code | int | Y | 0 | 응답 코드 | |
message | String | Y | success | 응답 메시지 | |
value | Object | N | 응답 값 |
value
Name | Type | Required | Default Value | Example | Description |
member_no | String | Y | 108131345 | ||
guid | String | N | 20000025262 |
guid
guid는 게임이용약관 동의 시 생성 되는 게임 고유 ID 입니다.
게임이용약관 동의가 안 된 member_no의 경우 response 값으로 guid를 return 받을 수 없습니다.
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
Code type : application/json
{
"code": 0,
"message": "success",
"value": {
"member_no": 20005061986,
"guid": 200000000397
}
}
JSON
복사
잘못된 파라메터
{
"code": 40000,
"message": "bad request"
}
JSON
복사
잘못된 game_id
{
"code": 41002,
"message": "Invalid game id"
}
JSON
복사
Return Code
HTTP Status code | Code | Message | Description |
200 | 0 | Success | 응답 성공 |
200 | 40000 | bad request | 잘못된 파라미터
- 토큰 전달 누락
- 쿼리 파라미터 누락 |
200 | 41002 | Invalid game id | 잘못된 game_id
- 토큰 내 게임id와 요청 게임id가 다른 경우 |
401 | 40101 | Invalid game id | 유효하지 않은 Access Token으로 호출했을 경우 |