04/28/2025 20:45:30
백엔드 전체 설명
1 연동 프로세스
기업 Wechat 으로 MSDK도우미 에게 연락하십시오
2 서버 연동 방법
http(rest api)모드는, game server 에서 http 인터페이스를 직접 호출하여 인증 및 친구 관계 체인 호출을 진행합니다.
3 전체 설명
- HTTP/HTTPS 인터페이스 프로토콜, POST 요청；
- URL 을 요청하여 os, gameid, channelid, version, sig, ts 등을 포함한 고정 파라미터 가져오기；
- POST body 는 json 문자열；
- 인터페이스의 모든 파라미터는 utf8 코딩임；
- 서버 인터페이스 시간 초과 기준은 3100ms 임；
3.1 환경
| 환경（도메인네임） | HTTP 인트라넷 | HTTPS 엑스트라넷 |
|---|---|---|
| 테스트 환경 | hktest.itop.tencent-cloud.net | hktest.itop.qq.com |
| 국내 정식 환경 | itop.tencent-cloud.net | itop.qq.com / ipv6-sh.itop.qq.com |
| 싱가포르 정식 환경 | 없음 | sg.itopsdk.com |
| 실리콘 밸리 정식 환경 | 없음 | us.itopsdk.com |
3.2 URL 요청
- URL 포맷：http://xxxxx/v2/modulename/interfacename?channelid=1&gameid=11&os=1&source=0&ts=1528097722&version=0.1&sig=xx
- modulename：기능 분류；
- interfacename：인터페이스 이름；
- 고정 파라미터 설명；
| 파라미터 | 유형 | 설명 |
|---|---|---|
| os | string | [필수] 운영 체제 표시 1 - Android, 2 - iOS, 3 - Web，4 - Linux, 5 - windows .... |
| gameid | string | [필수] MSDK 에 배급된 게임id |
| channelid | int | [필수] 로그인 채널 id 1 - Wechat(WeChat)，2 - 모바일Q(mqq)，3 - 게스트(Guest)，4 - Facebook，5 - GameCenter，6 - GooglePlay，7 - IEGPass，9 - Twitter，10 - garena，11 - SelfAccount，12 - EGame，14 - Line，15 - Signin with Apple，17 - Kwai |
| ts | uint32 | [필수]Unix time |
| version | string | SDK 버전을 의미하며, 기본값으로 null（ 클라이언트 호출 시 항상 필요합니다!） |
| sig | string | [필수] 서명 필드 서명 알고리즘 md5(path + "?" + params + body + sigkey)， 1. path： 인터페이스 경로, 예: 인증 인터페이스 이름 /v2/auth/verify_login 2. params：에는 2 step 이 필요합니다；a. sig 를 제외한 인터페이스로 파라미터 요청（즉, sig 를 제외하고 현재 인터페이스에서 url 로 호출되는 다른 파라미터와 일치합니다）, b. 파라미터를 사전 순서로 정렬 3. body：post 의 body 부분, body 부분은 사전 순서로 정렬할 필요가 없고, 인터페이스 파라미터 순으로 전달하면 됨 4. sigkey：sigkey 와 source 필드는 밀접한 관계가 있으며, MSDK 사바에서 sig 검증 시, source 에서 대응하는 sigkey 로 sig 계산， source 가 입력되지 않거나 0 일 경우, sigkey 는 Feiying 시스템 파라미터의 MSDK_SDK_KEY 사용； source 가 1 인 경우, sigkey 는 Feiying 시스템 파라미터의 MSDK_SERVER_KEY 사용； source 가 2 인 경우, sigkey 는 Feiying 시스템 파라미터의MSDK_MIDAS_KEY 사용； 5. md5 계산 예：/v2/auth/verify_login?channelid=1&conn=&gameid=11&os=2&seq=&source=0&ts=1556072078&version={"openid":"11219380013689673060","token":"B8D116F42A6A8116398C40AED587195C"}sigkey Feiying 시스템 에서 >MSDK 연동>MSDK_V5 툴, 클라이언트 인터페이스를 호출하여 시뮬레이션 진행하고, 그 다음 url 에서 시스템으로 계산된 sig 값과 업무에서 자체 계산한sig 를 비교하고 검증 메시지 암호 해독 인터페이스(/v2/auth/decrypt) 의 서명 방법과 다름. 방법은：md5(timestamp+암호화 데이터+sigkey)임. |
| conn | int | 지속적인 연결 사용 여부를 나타내며, conn=1 는 persistent connection며, 기본값 0 사용이 가능함 |
| seq | string | pass-through 된 파라미터를 의미하며, 리턴된 json 에 이 pass-through 파라미터를 호출하는 측 비동기에 사용합니다. 알파벳, 숫자, 밑줄로만 구성할 수 있으며, 기본값은 빈 값입니다 |
| source | int | 【필수】 액세스 출처. 값 범위： 0 또는 입력 안함 - 클라이언트, 서명 보안 키는 MSDK_SDK_KEY 값을 사용하며, 1 - 서버, 서명 보안 키는 MSDK_SERVER_KEY 값을 사용 2 - Midas, 서명 보안 키는 MSDK_MIDAS_KEY 값 사용 |
3.3 패킷 반환 및 오류 설명
http 프로토콜을 통해 데이터를 발송한 후, 상태 코드를 획득합니다. 200 인 경우, 요청이 정상적임을 의미하며, http 에서 리턴한 내용을 획득할 수 있습니다. json 문자열을 배열로 해석 가능합니다. 200 이 아닌 경우, 요청 실패를 의미하며, 결과를 출력하여 문제를 확인할 수 있습니다. 패킷 반환 포맷은 아래와 같습니다：
{
"ret":0,
"msg":"user is logged in",
.................
}
- ret = 0, 요청 성공을 의미하며, 관련 리턴 필드 정보를 해석할 수 있습니다;
- ret != 0, 로직 실패를 의미하며, msg 에서 구체적인 오류 메시지를 확인하실 수 있으며, 다른 필드의 리턴은 없습니다.
Copyright © 2025 MSDK.
All rights reserved.
All rights reserved.