04/28/2025 20:45:30
로그인 인증
1 인증
1.1 인터페이스 이름
/v2/auth/verify_login
1.2 요청 파라미터
파라미터 | 유형 | 설명 |
---|---|---|
openid | string | [필수] openid |
token | string | [필수] token |
1.3 리턴 파라미터
파라미터 | 유형 | 설명 |
---|---|---|
ret | int | 리턴코드 0:성공, 기타:실패 |
msg | string | 리턴 결과에 상세 설명 포함 |
1.4 요청 예시
요청:
{ "openid":"4724195171999796436", "token":"27A50B44430AAD6BFFBE09BA875E48BB" }
리턴:
{ "ret":0, "msg":"user is logged in.", "seq":"123" }
2 암호 해독 검증
2.1 인터페이스 이름
/v2/auth/decrypt(본 인터페이스는 GET 요청을 위한 것임)
2.2 요청 파라미터
파라미터 | 유형 | 설명 |
---|---|---|
itopencodeparam | string | [필수] 암호화된 문자열 |
2.3 리턴 파라미터
itopencodeparam 암호 해독 후의 명문으로 성공 리턴됩니다. 실패 시, JSON 문자열로 리턴되며, 필드는 아래와 같습니다:
파라미터 | 유형 | 설명 | 예시 |
---|---|---|---|
ret | int | 리턴코드 | 10006 |
msg | string | ret 가 0 이 아닌 경우, 상세 오류 정보가 리턴됨 | "decryp data fail!" |
seq | string | url 의 seq 필드 요청 | "12345" |
2.4 요청 예시
요청 URL
https://hktest.itop.qq.com/v2/auth/decrypt?channelid=1&gameid=11&os=1&source=0&ts=1529907080&sig=8279b3214fc4900e7551ee21593b4d80&itopencodeparam=d9b48147c3b809a2bebbd8b2e96c26f1
응답
openid=4FC5813635C21D7C0A64729E4E2D3041&access_token=B85D2A1D7DB1B564CADE7116BF70AD0D&gopenid=5874557358053167501&appid=100703379&acctype=qq&platid=1
3 pf 와 pfkey 획득
3.1 인터페이스 이름
/v2/auth/get_pfval
3.2 요청 파라미터
파라미터 | 유형 | 설명 |
---|---|---|
openid | string | [필수] openid |
token/pay_token | string | [필수] QQ 로그인에 필요한 pay_token, 기타 로그인 채널에 경우 token 이 필요함 |
channel_dis | string | [필수] 채널 분배 |
3.3 리턴 파라미터
파라미터 | 유형 | 설명 |
---|---|---|
ret | int | 리턴코드 0:성공, 기타:실패 |
msg | string | 리턴 결과에 상세 설명 포함 |
pf | string | 대응하는 pf 값 |
pf_key | string | 대응하는 pfKey 값 |
3.4 요청 파라미터 예시
요청:
{ "channel_dis":"TEST", "openid":"11446279220371186239", "pay_token":"396A1198D087D987641CD8F6EFFE7D68" }
리턴:
{ "ret":0, "msg":"success", "pf":"qq_qq-TEST-android-TEST-qq-1106977030-F759BCD85FDB760A18BABC3A37DF5F6A", "pf_key":"3f80bb2980d50e1b7c785d9197c32a83" }
Copyright © 2025 MSDK.
All rights reserved.
All rights reserved.