게임유저 아이디 조회

소개

•

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

API Access Token 발급

API Access token은 Game User 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

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으로 호출했을 경우