개별모듈 세션 검증

게임 클라이언트에서 로그인 성공 후 반환된 세션 키와 UID를 이용하여 게임 서버에서는 로그인 한 유저의 세션 키의 유효성 여부를 검증할 수 있습니다. 로그인 한 유저가 회원 프로필에서 러비페이지로, 또는 게임에서 러비 웹샵으로 이동할 경우에도 세션 키의 유효성을 검증합니다. 중국의 과몰입 방지 실명 인증 시스템에 대응하기 위해 Request에 getpi 필드를 추가하고, Response에서 PI 값을 획득하세요.

  • Request URL
상용 URL https://api.qpyou.cn/gameserver/user/sessionkey_verify
테스트 URL https://test-api.qpyou.cn/gameserver/user/sessionkey_verify
HTTP Method Post
Content-Type application/json
Data Format JSON
  • Request
필드명 설명 타입 필수여부
type API 타입 String Y
uid Hive UID String Y
gameindex App Index Integer Y
sessionkey Hive 정회원 로그인 세션키 String Y
did 디바이스 ID String Y
getpi 중국 유저 PI (고유 식별키) - 중국 과몰입 API에서 획득한 키 String N ("Y": 중국 유저 PI 값 요청)
  • Response
필드명 설명 타입
type api 타입 String
error_code 에러코드 Integer 0:성공, 0 이외의 코드: 에러
error_msg 에러 메시지(에러 코드가 0이 아닐 경우) String "Database error occurred."
is_verified session 검증 결과 Boolean true: 세션 검증 성공, false: 세션 검증 실패
uid 유저 UID String
id 유저 ID String
name 사용자가 입력한 이름 또는 facebook name String 데이터 없으면 null, 최대 128자
fbid 페이스북 연동시 FB UID 정보 String 데이터 없으면 null
googleplus_id 구글플러스 연동시 UID 정보 String 데이터 없으면 null
sinaweibo_id 시나웨이보 연동시 UID 정보 String 데이터 없으면 null
email 이메일 String
picture 프로필 이미지 URL String picture
country 국가 코드 String 2자리 국가 코드
birthday 생년월일 String 데이터 없으면 null
gender 성별 String "M", "F"
language 언어 정보 String "KOR", "ENG"
comment 코멘트 String
cached 캐시된 정보인지 여부 Boolean true: 캐시 서버에서 데이터 반환, false: DB 서버에서 데이터 반환
is_test_account 테스트 계정인지 여부 Integer
pi 중국 유저 PI (고유 식별키) - 중국 과몰입 API에서 획득한 키 String PI 반환 성공: "1fffbjzos82bs9cnyj1dna7d6d29zg4esnh99u"
PI 반환 실패: "" or null
(※Request Body에 getpi=Y를 보내는 경우에만 Response 객체에 PI 값이 반환됨)
  • Request Sample
{ 
     "uid":"1489480",
     "did":"20286732",
     "gameindex":1086,
     "sessionkey":"3d144857a8f81595434bcf667bb282"
}
  • Response Sample
{ 
    "type": "gameserver/user/sessionkey_verify",
    "error_code": 0,
    "is_verified": true,
    "uid": "1489480",
    "id": "DrNoiz",
    "name": "YoungJun Seo",
    "fbid": null,
    "googleplus_id": null,
    "sinaweibo_id": null,
    "email": "pr0419y@grr.la",
    "picture": "http://image.com2us.com/hubweb/avatar_img/00094/0005d1/0003a2e/1abebb4880fd51ebbdfa76b107e2be6c_public_s.jpg?1320213205",
    "country": "KR",
    "birthday": null,
    "gender": null,
    "language": "KOR",
    "comment": "",
    "cached": true,
    "is_test_account": 0
}
  • Request Sample (중국 과몰입 방지 시스템 대응을 위한 getpi 포함)
{ 
     "uid":"1489480",
     "did":"20286732",
     "gameindex":1086,
     "sessionkey":"3d144857a8f81595434bcf667bb282",
     "getpi":"Y"
}
  • Response Sample (중국 과몰입 방지 시스템 대응을 위한 pi 포함)
{ 
    "type": "gameserver/user/sessionkey_verify",
    "error_code": 0,
    "is_verified": true,
    "uid": "1489480",
    "id": "DrNoiz",
    "name": "YoungJun Seo",
    "fbid": null,
    "googleplus_id": null,
    "sinaweibo_id": null,
    "email": "pr0419y@grr.la",
    "picture": "http://image.com2us.com/hubweb/avatar_img/00094/0005d1/0003a2e/1abebb4880fd51ebbdfa76b107e2be6c_public_s.jpg?1320213205",
    "country": "KR",
    "birthday": null,
    "gender": null,
    "language": "KOR",
    "comment": "",
    "cached": true,
    "is_test_account": 0,
    "pi": "1fffbjzos82bs9cnyj1dna7d6d29zg4esnh99u"
}
  • Error Code
코드값 메시지 설명
1101 Database error occurred DB 에러 발생
1400 This service to device is denied. 차단된 디바이스
1401 This service to user is denied. 차단된 사용자 UID
2300 Refund Block User 환불 유저 재결제 대상
  • Response Sample (error)
{ 
    "type":"user/sessionkey_verify",
    "error_code":1400,
    "error_msg":"This service to device is denied."
}