# 게임유저 아이디 조회(서버용)
# 소개
* 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
1
2
3
4
2
3
4
# Request
# Header
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| Authorization | String | Y | Bearer {api_access_token} | API Access Token |
API Access Token 발급
API Access token은 API Access Token 발급 - 링크페이지 참고을 통해 발급 받습니다.
# Parameter (Query String)
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| search_type | String | Y | MEMBER_NO | 종류 member_no / guid | |
| 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 | member_no :플랫폼 고유ID | |
| guid | String | N | 20000025262 | guid : 게임 고유ID |
value의 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'
1
2
2
# Response
Code type : application/json
{
"code": 0,
"message": "success",
"value": {
"member_no": 20005061986,
"guid": 200000000397
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
잘못된 파라메터
{
"code": 40000,
"message": "bad request"
}
1
2
3
4
2
3
4
잘못된 game_id
{
"code": 41002,
"message": "Invalid game id"
}
1
2
3
4
2
3
4
# 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으로 호출했을 경우 |