종합 설명

1）msdk 백그라운드에서 제공하는 http 인터페이스 프로토콜, post 요구사항；
2）url 상에서 요구하는 것은 고정된 get 파라미터로 appid, sig, timestamp, encode 등이 포함됨；
3）body 일부는 json 스트링;
4）인터페이스 내 모든 파라미터는 utf8 코드;
5）백그라운드 인터페이스 초과 시간은 3100ms；

1.환경

2. 파라미터

1)고정 get 파라미터 부분:
형식:

http://msdk.qq.com/modulename/interfacename?timestamp=x3&appid=x4&sig=x5&openid=x6&encode=x7&version=x8&ishttps=x9

modulename: 기능 분류
interfacename：인터페이스 이름；
각 인터페이스의 상세 설명에 주의를 기울이십시오.；

2) http body(post)
body는 json형식의 특스트 문자열이며, 기본값은 일반텍스트임. http 헤드 설정이 아래 값과 같은 경우, 암호문임(리턴 패키지 포함):

Content-Encrypt=msdktea；![](길드)
Accept-Encrypt=msdktea；

3) sig 생성 규칙
encode=1인 경우: sig = md5 (appkey + timestamp)
encode=2인 경우: sig = md5 (msdkkey+ timestamp)
+ 두 문자열 연결을 나타내며, 비문자열은 "+";

4) https 호환성
현재 MSDK의 반환 헤드 링크에서 https를 지원하며, 2개 유형을 선택할 수 있습니다. GET 요청 내 보유 version=2.16.0i 이상 버전, 또는 ishttps=1(우선 사용 권장)

3. 결과

http 프로토콜을 통해 데이터를 보낸 후 상태 코드를 획득하며, 200일 경우에는 요청이 정상임을 나타내고, 곧 http 회신 내용을 획득할 수 있으며, json 문자열 분석으로 구성됩니다. 200이 아닌 경우 요청 실패를 의미하며, 직접 결과를 인쇄하여 문제를 확인합니다.

4.예시 (php)

<?php
require_once 'SnsNetwork.php';
$appid = "xxxxxxxxxx";
$appKey = "f92212f75cd*********";
$openid = "F4382318Axxxxxxxxxx2066043C3472E";
$ts = time();
//md5 32비트 소문자, 예: "111111"의 md5는 "96e79218965e*********d5a330112";
$sig = md5($appKey.$ts);
$url= "http://msdktest.qq.com/relation/qqfriends_detail?timestamp=$ts&appid=$appid&sig=$sig&openid=$openid&encode=1";
$param = array(
    "appid"=> xxxxxxx,
    "openid"=>"A3284A8xxxxxxxxx1C2D94EB37",
    "accessToken"=>"933FExxxxxxxxxBD04373B7155F"
);
$result = SnsNetwork::makeRequest($url,json_encode($param));
print_r($result);

로그인

특수 설명: 모든 인터페이스 로그인 기능 분류 명칭 auth 및 wxoauth는 효과가 같으며 서로 교체할 수 있음；

개요

일반 로그인 절차:

클라이언트 서명 권한 부분은 로그인의 핵심 경로이며, 게임은 게임 백그라운드 접수를 통해 완료해야 합니다.

모바일QQ 서명 권한[必接]

1）인터페이스 명칭: /auth/verify_login
2）인터페이스 설명: 사용자 로그인 상태를 검사하며 access_token 기한 만료 여부를 판단합니다. url 내에 msdkExtInfo=xxx(시리얼 번호 청구)를 보유하고 있을 경우, 후속 반환 내용 중에서 msdkExtInfo의 본래 데이터를 보유하고 순수한 이상 요청을 구현할 수 있습니다. msdkExtInfo는 선택 가능한 파라미터입니다.
3）URL 형식:

http://msdktest.qq.com/auth/verify_login?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시 코드:

POST /auth/verify_login?timestamp=1478745715&appid=xxxxxxxx&sig=3f046bxxxxxxxxxx11119f&openid=A3284A8xxxxxxxxxxE1C2D94EB37&encode=2 
HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "appid": xxxxxxxxxxx,
    "openid": "A328xxxxxxxxxxxxxD94EB37",
    "openkey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "userip": "192.168.5.114"
}

//반환 결과: 
{"ret":0,"msg":"user is logged in"}

위챗 서명 권한[필수 접수]

1）인터페이스 이름: /auth/check_token
2）인터페이스 설명: 위챗에서 승인 증명 자료(access_token)의 유효성을 검증합니다.
url 내에 msdkExtInfo=xxx(시리얼 번호 청구)를 보유하고 있을 경우, 후속 반환 내용 중에서 msdkExtInfo의 본래 데이터를 보유하고 순수한 이상 요청을 구현할 수 있습니다. msdkExtInfo는 선택 가능한 파라미터입니다.
3）URL형식:

http://msdktest.qq.com/auth/check_token?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시 코드:

POST /auth/check_token?timestamp=1478745715&appid=100703379&sig=3f046b1cdd74e44f2832c1000e11119f&openid=oGRTijiaT-XrbyXKozckdNHFgPyc&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJPLafWudG-idTVMbKesBkhBO_ZxFWN4zlXCpCHpYcrXNG6Vs-cocorhdT5Czj_23QF6D1qH8MCldg0BSMdEUnsaWcFH083zgWJcl_goeBUSQ",
    "openid": "oGRTijiaT-XrbyXKozckdNHFgPyc"
}

//반환 결과
{"ret":0,"msg":"ok"}

게스트 서명 권한[필수 접수]

1）인터페이스 이름: /auth/guest_check_token
2）인터페이스 설명: 게스트 모드 하단에서 해당 인터페이스 서명 권한을 호출합니다.
3）URL 형식:

http://msdktest.qq.com/auth/guest_check_token?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시 코드:

POST /auth/guest_check_token?timestamp=1478745715&appid=G_100703379&sig=3f046b1cdd74e44f2832c1000e11119f&openid=G_oGRTijiaT-XrbyXKozckdNHFgPyc&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJPLafWudG-idTVMbKesBkhBO_ZxFWN4zlXCpCHpYcrXNG6Vs-cocorhdT5Czj_23QF6D1qH8MCldg0BSMdEUnsaWcFH083zgWJcl_goeBUSQ",
    "guestid": "G_oGRTijiaT-XrbyXKozckdNHFgPyc"
}

//반환 결과
{"ret":0,"msg":"ok"}

pf 및 pfkey 획득

1）인터페이스 이름: /auth/get_pfval
2）인터페이스 설명: 파라미터 입력을 통해 pf 및 pfkey 값을 얻습니다.
3）URL형식:

http://msdktest.qq.com/auth/get_pfval?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시 코드:

POST /auth/get_pfval/?timestamp=1491527653&appid=wxcde873f99466f74a&sig=161bb45ba800811d1220ab24acfbc83b&version=3.0.0a&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "appid":"wxcde873f99466f74a",
    "openid":"oyQmcwlfqLdebciSJTiGy8Bm5N40",
    "accessToken":"u2OLuoBXgeJpL206s4Y6l1gb6vQDpL6dopCN9VGTUv7GRjUvxgxXT78Mxj-1SdYeRUObVB1FFbugXCpwYG_EPyKy0-HEnu6d861OB-xoVA8",
    "platform":"desktop_m_wx",
    "regChannel":"2002",
    "os":"android",
    "installchannel":"73213123",
    "offerid":"1104674695"
}

//반환 결과
{
    "pf": "desktop_m_wx-2002-android-73213123-wx-wxcde873f99466f74a-oyQmcwlfqLdebciSJTiGy8Bm5N40",
    "pfKey": "60de2c996**********9a81f8ccb0",
    "msg": "ok",
    "ret": 0
}

관계 사슬

[모바일QQ]고객 정보:

1）인터페이스 이름: /relation/qqprofile
2）인터페이스 설명: 사용자 QQ 계정 기본 정보를 얻습니다.
3）URL 형식:

http://msdktest.qq.com/relation/qqprofile?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/qqprofile/?timestamp=*&appid=**&sig=***&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "appid": "100703379",
    "accessToken": "FCCDE5C8CDAD70A9A0E229C367E03178",
    "openid": "69FF99F3B17436F2F6621FA158B30549"
}

//반환 결과
{
    "ret": 0,
    "msg": "success",
    "nickName": "xxx",
    "gender": "남성",
    "picture40": "http://q.qlogo.cn/qqapp/100703379/A3284A812ECA15269F85AE1C2D94EB37/40",
    "picture100": "http://q.qlogo.cn/qqapp/100703379/A3284A812ECA15269F85AE1C2D94EB37/100",
    "yellow_vip": 0,
    "yellow_vip_level": 0,
    "yellow_year_vip": 0,
    "is_lost": "0"
}

[모바일QQ]친구 정보

1）인터페이스 이름: /relation/qqfriends_detail
2）인터페이스 설명: QQ 같은 게임 플레이 친구 상세 정보를 획득하는 개인 정보 인터페이스.
3）URL 형식:

http://msdktest.qq.com/relation/qqfriends_detail?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

struct QQGameFriendsList {
    string          openid;      //친구 openid
    string          nickName;   //닉네임(우선 비주 출력, 없으면 닉네임 출력)
    string          gender;      //성별, 사용자가 입력하지 않으면 기본값은 남성 반환
    string          figureurl_qq;  //친구 QQ 프로필 사진 URL, 반드시 URL 뒤에 다음 파라미터/40，/100처럼 추가해 다양한 크기의 이미지를 각각 획득 가능 
　　40*40(/40)、100*100(/100)
};

6) 예시:

POST /relation/qqfriends_detail/?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa852&openid=F4382318AFBBD94F856E8%2066043C3472E&encode=1

{
    "appid": “100703379”,
    "openid": "A3284A812ECA15269F85AE1C2D94EB37",
    "accessToken": "933FE8C9AB9C585D7EABD04373B7155F",
    "flag": 1,
    "closefriends_flag": 1
}
//반환 결과
{
    "ret": 0,
    "msg": "success",
    "lists": [
    {
        "openid": "69FF99F3B17436F2F6621FA158B30549",
        "nickName": "xxx",
        "gender": "남성",
        "figureurl_qq": "http://q.qlogo.cn/qqapp/100703379/69FF99F3B17436F2F6621FA158B30549/"
    }
    ],
    “extinfo”:{
        "closefriend_lists" : [
            "DB8830DFD91050D6BD9CFAC29121C98B", 
            "DB8830DFD91050D6BD9CFAC29121C98B"
        ]
    },
    "is_lost": "0"
}

[모바일QQ]친구 정보(해당 애플리케이션 아직 등록 안함)

1）인터페이스 이름: /relation/qq_unreg_friends
2）인터페이스 설명: 모바일QQ 친구 목록 상의 해당 앱에 등록하지 않은 친구 정보.
비주: 미등록 친구 정보 획득은 게임 성과 보고이며, 성과 보고에 아직 액세스하지 않았을 경우(:/profile/qqscore_batch), 해당 인터페이스 호츨을 허용하지 않음
3）URL 형식:

http://msdktest.qq.com/relation/qq_unreg_friends?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

struct QQUnregFriendsList {
    string          openid;       //친구 openid
    string          nick_name;    //친구 닉네임(qq 닉네임을 반환하며, 비주는 반환하지 않음)
    string          head_img_url; //친구 프로필 사진
};

6) 예시:

POST /relation/qq_unreg_friends/?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa852&openid=F4382318AFBBD94F856E8%2066043C3472E&encode=2

{
    "accessToken": "933FE8C9AB9C585D7EABD04373B7155F",
    "count": 20
}
//반환 결과
{
    "ret": 0,
    "msg": "success",
    "friends": [
    {
        "openid": "67063124582BE5086B203F543E4F643C",
        "nick_name": "xxx",
        "head_img_url": "http://thirdqq.qlogo.cn/qqapp/1104466820/67063124582BE5086B203F543E4F643C/100"
    }
    ]
}

[모바일QQ]같은 게임 플레이 친구

1）인터페이스 이름: /relation/qqstrange_profile
2）인터페이스 설명: 같은 게임 플레이 모르는 사람(친구 포함) 개인 정보 획득.
PS: 1. 이 인터페이스는 현재 “주변 사람” 등의 기능의 게임 사용만을 개발했습니다.
2. 곧, 먼저 클라이언트에서 같이 플레이하는 모르는 사람의 openid 목록을 획득한 후에 이 인터페이스를 호출할 수 있음

3）URL 형식:

http://msdktest.qq.com/relation/qqstrange_profile?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

struct QQStrangeList {
    string          openid;          //openid
    string          gender;          //성별 "1"
    string          nickName;        //닉네임
    string          qzonepicture50;  //사용자 프로필 사진 크기는 50×50 화소의 친구 QQ 스페이스 프로필 사진 URL
    string          qqpicture40;     //사용자 프로필 사진 크기는 40×40 화소의 친구 QQ 프로필 사진 URL
    string          qqpicture100;    //사용자 프로필 사진 크기는 100×100 화소 친구 QQ 프로필 사진 URL
    string          qqpicture;       //사용자 프로필 사진 크기는 적절한 화소의 친구 QQ 프로필 사진 URL이 되며, 반드시 URL 뒤에 /40, /100와 같이 파라미터를 추가해야 각각 다채로운 크기의 사진을 획득할 수 있습니다.: 40*40(/40), 100*100(/100)
};

6) 예시:

POST /relation/qqstrange_profile/?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa***&openid=F4382318AFBBD94F856E8%2066043C3472E&encode=1

{
    "appid": 100732256,
    "openid": "B9EEA5EE1E99694146AC2700BFE6B88B",
    "accessToken": "C9A1F622B7B4AAC48D0AF3F73B1A3D83",
    "vcopenid": [
    "B9EEA5EE1E99694146AC2700BFE6B88B"
    ]
}
//반환 결과
{
    "ret": 0,
    "msg": "success",
    "lists": [
    {
        "openid": "B9EEA5EE1E99694146AC2700BFE6B88B",
        "gender": "1",
        "nickName": "/xu゛♥얼른 여기로 와இ",
        "qzonepicture50": "http://thirdapp1.qlogo.cn/qzopenapp/aff242e95d20fb902bedd93bb1dcd4c01ed5dc2a14b37510a81685c74529ab1e/50",
        "qqpicture40": "http://q.qlogo.cn/qqapp/100732256/B9EEA5EE1E99694146AC2700BFE6B88B/40",
        "qqpicture100": "http://q.qlogo.cn/qqapp/100732256/B9EEA5EE1E99694146AC2700BFE6B88B/100",
        "qqpicture": "http://q.qlogo.cn/qqapp/100732256/B9EEA5EE1E99694146AC2700BFE6B88B"
    }
　　　],
　　　"is_lost": "0"
}

[모바일QQ]회원 정보

1）인터페이스 이름: /relation/qqfriends_vip
2）인터페이스 설명: QQ 회원 정보 대량 검색(친구/친구 아닌 사용자 모두 지원).
3）URL 형식:

http://msdktest.qq.com/relation/qqfriends_vip?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/qqfriends_vip?timestamp=1478745715&appid=100703379&sig=3f046b1cdd74e44f2832c1000e11119f&openid=A3284A812ECA15269F85AE1C2D94EB37&encode=2   HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "appid": "100703379",
    "openid": "A3284A812ECA15269F85AE1C2D94EB37",
    "accessToken": "964EE8FACFA24AE88AEEEEBD84028E19",
    "fopenids": [
        "69FF99F3B17436F2F6621FA158B30549"
    ],
    "flags": "qq_vip,qq_svip",
    "pf": "openmobile_android",
    "userip": "127.0.0.1"
}
//반환 결과
{
    "is_lost": "0",
    "lists": [
        {
            "is_qq_vip": 1,
            "is_qq_year_vip": 1,
            "openid": "69FF99F3B17436F2F6621FA158B30549",
            "qq_vip_level": 6,
            "is_qq_svip": 1
        }
    ],
    "msg": "success",
    "ret": 0
}

[모바일QQ]회원 정보

1）인터페이스 이름: /relation/get_vip_rich_info
2）인터페이스 설명: 모바일QQ 회원 상세 정보 확인(충전 시간 & 만료 시간)
3）URL 형식:

http://msdktest.qq.com/relation/get_vip_rich_info?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/get_vip_rich_info?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 134

{
    "appid": "100703379",
    "accessToken": "E16A9965C446956D89303747C632C27B",
    "openid": "F4382318AFBBD94F856E866043C3472E"
}

//반환 결과
{
    "is_lost": "0",
    "is_qq_vip": "0",
    "msg": "success",
    "qq_svip_end": "0",
    "qq_svip_start": "0",
    "qq_vip_end": "1448817920",
    "qq_vip_start": "1443461120",
    "qq_year_vip_end": "0",
    "qq_year_vip_start": "0",
    "ret": 0,
    "is_qq_year_vip":"1",
    "is_svip":"1"
}

[모바일QQ]길드 그룹 결합

1）인터페이스 이름: /relation/createbind_groupv2
2）인터페이스 설명: 길드 회장의 QQ 그룹 생성 및 직접 결합 인터페이스(새 기능)(사용 시에 권한 신청 필요)
3）URL 형식:

http://msdktest.qq.com/relation/createbind_groupv2?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/createbind_groupv2?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 205

{
    "appid":"100703379",
    "guild_id":"1234",
    "zone_id":"1234",
    "guild_name":"그룹 기능 테스트",
    "platid":"1234",
    "roleid":"1234",
　　"partition":"1234",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "gc": "514915385",
        "group_name": "중국어 테스트1"
    }
}

[모바일QQ]그룹 관계 검색

1）인터페이스 이름: /relation/get_groupinfov2
2）인터페이스 설명:길드의 그룹 결합 후에 해당 인터페이스를 호출해 사용자와 그룹 사이의 관계 정보를 확인하는 인터페이스. 사용자와 그룹의 관계(그룹 주인, 관리자, 일반 구성원, 비 구성원) 정보 반환 가능.(새 기능)(사용 시에 권한 신청 필요)
3）URL 형식:

http://msdktest.qq.com/relation/get_groupinfov2?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/get_groupinfov2?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 98

{
    "appid":"100703379",
    "gc":"426177396",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "relation": 1
    }
}

[모바일QQ]그룹 가입

1）인터페이스 이름: /relation/join_groupv2
2）인터페이스 설명: 게임 내 길드 구성원의 QQ 그룹 가입 인터페이스. 해당 인터페이스 호출 전에 먼저 /relation/get_groupinfov2 인터페이스를 호출해 사용자가 그룹 구성원인지 확인하고, 사용자가 비 구성원 신분인 경우에는 그룹 가입 버튼을 표시.(새 기능)(사용 시에 권한 신청 필요)
3）URL 형식:

http://msdktest.qq.com/relation/join_groupv2?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/join_groupv2?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 205

{
    "appid":"100703379",
    "guild_id":"123",
    "zone_id":"123",
    "gc":"511720053",
    "partition":"1",
    "platid":"1",
    "roleid":"1",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "empty": ""
    }
}

[모바일QQ]그룹 결합 해제

1）인터페이스 이름: /relation/unlink_groupv2
2）인터페이스 설명: 게임 내에서 QQ 그룹과의 결합 인터페이스. 사용자가 길드 QQ 그룹을 해산한 경우, 길드와 길드 QQ 그룹은 자동으로 결합 해제 되지 않음(새 기능)(사용 시에 권한 신청 필요)
***PS：그룹 해산에 두 가지 방식이 있을 경우, 결합 관계 취소 가능:

1. 회장 호출 결합 해제 인터페이스 그룹 관계 해산
   
2. 길드 구성원이 그룹 가입 인터페이스를 호출하면, 이때는 그룹 ID를 찾을 수 없으며, 기본적으로 그룹 결합 해제 실시
   QQ 그룹이 해산되고 이상의 조치 중 어느 하나로 처리하지 않았을 경우, 결합 관계는 자동으로 취소되지 않습니다.
   
3. 회장이 양도한 후에 새로운 회장도 결합 해제 조작을 실시할 수 있습니다.***
   3）URL 형식:
   

http://msdktest.qq.com/relation/unlink_groupv2?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/unlink_groupv2?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 141

{
    "appid":"100703379",
    "guild_id":"123",
    "zone_id":"123",
    "platid":"1",
    "roleid":"1",
    "guild_name":"중국어 테스트1",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "empty": ""
    }
}

[모바일QQ]QQ 그룹 목록 인터페이스

1）인터페이스 이름: /relation/get_group_listv2
2）인터페이스 설명: 길드 회장이 길드를 자신이 이미 생성한 QQ 그룹에 결합할 경우, 이미 생성한 그룹 목록 인터페이스를 불러오는 데 사용합니다.
3）URL 형식:

http://msdktest.qq.com/relation/get_group_listv2?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/get_group_listv2?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 141

{
    "appid":"100703379",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "group_list": [
                        {"gc": "","group_name": ""}
                      ]

    }
}

[모바일Q]생성된 QQ 그룹 인터페이스 결합

1）인터페이스 이름: /relation/bind_existing_groupv2
2）인터페이스 설명: 길드 회장이 길드를 자신이 생성한 QQ 그룹에 결합할 수 있음. 해당 인터페이스를 호출하기 전에 먼저 /relation/get_group_listv2 인터페이스를 호출해 이미 생성한 그룹 목록표를 불러옵니다.
3）URL 형식:

http://msdktest.qq.com/relation/bind_existing_groupv2?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/bind_existing_groupv2?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 141

{
    "appid":"100703379",
    "guild_id":"123",
    "zone_id":"123",
    "gc":"511720053",
    "partition":"1",
    "platid":"1",
    "roleid":"1",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "empty": ""
    }
}

[모바일QQ]회장에게 인터페이스 결합 메시지 표시

1）인터페이스 이름: /relation/remind_leader_bindv2
2）인터페이스 설명: 길드가 이미 결합되었을 경우, 회원이 회장에게 그룹 결합 인터페이스 메시지를 보낼 수 있습니다. 길드를 자신이 생성한 QQ 그룹에 결합하고 공공 계정 “QQ 모바일 게임”을 통해 통지를 수신하며, 이용 횟수는 1일 1건 수신으로 제한됩니다. 메시지 발신자 및 수신자 확인은 길드 구성원이어야만 실행 가능하며, 게임 측에서 수신인이 길드 회장임을 보증합니다.
3）URL 형식:

http://msdktest.qq.com/relation/remind_leader_bindv2?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/remind_leader_bindv2?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 141

{
    "appid":"100703379",
    "guild_id":"123",
    "zone_id":"123",
    "gc":"511720053",
    "partition":"1",
    "platid":"1",
    "roleid":"1",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "empty": ""
    }
}

[모바일QQ]그룹 결합된 길드 검색

1）인터페이스 이름: /relation/query_bind_unionv2
2）인터페이스 설명: 그룹 ID에 따라 결합된 길드 정보 검색
3）URL 형식:

http://msdktest.qq.com/relation/query_bind_unionv2?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/query_bind_unionv2?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 141

{
    "appid":"100703379",
    "guild_id":"123",
    "zone_id":"123",
    "gc":"511720053",
    "type":"0",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "union_id": "xxx",
        "union_name": "xxx"
    }
}

[모바일QQ]그룹 정보 가져오기(해당 인터페이스는 v2 인터페이스)

1）인터페이스 이름: /relation/get_groupcode
2）인터페이스 설명: 길드 ID를 통해 QQ 그룹의 그룹 번호를 불러올 수 있으며 결합 그룹이 있어야 합니다. 그룹 생성 시에 길드 이름을 입력하지 않으면 이때 회득한 그룹 이름은 공백입니다.
3）URL 형식:

http://msdktest.qq.com/relation/get_groupcode?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/get_groupcode?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 141

{
    "appid":"100703379",
    "guild_id":"123",
    "zone_id":"123",
    "type":"0",
    "accessToken":"B8C0CB75299FFEA623D766073BE5BC99"
}
//반환 결과
{
    "ret": 0,
    "message": "success",
    "data": {
        "gc": "xxx",
        "group_name": "xxx",
        "group_key": "xxx",
        "group_openid": "xxx"

    }
}

[모바일QQ]그룹 메시지 발송

1）인터페이스 이름:/relation/send_groupmsg
2）인터페이스 설명: 그룹 obj 메시지 푸시(사용 시에 권한 신청이 필요하며 권한 신청 시에는 콜백 주소를 모바일QQ 측에 제공해 설정해야 합니다. 콜백 주소가 공백일 경우, 권한을 신청할 수 없습니다.)
3）URL 형식:

http://msdktest.qq.com/relation/send_groupmsg?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/send_groupmsg?timestamp=*&appid=**&sig=***&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 132

{
    "appid":"1104359534",
    "accessToken":"4F05D9EFF140E2BB6527F266B1E674F1",
    "pf":"qqqun",
    "group_openid":"C672A42F0595BC8309D079D68F45B8CF",
    "title":"11",
    "desc":"11",
    "redirect_url":"http://www.qq.com/",
    "image_url":"http://p.qlogo.cn/gh/31asdasd0/312248990/100",
    "param":"11"
}

//반환 결과
{
    "ret": 0,
    "message": "success",
    "is_lost": "1"
}

[위챗]같은 게임 플레이 정보(프리미엄 게임 사용에만 제공하며 비주 없음)

1）인터페이스 이름: /relation/wxprofile
2）인터페이스 설명: 위챗 계정 같은 게임 플레이 친구 기본 자료 획득은 비주가 없으며 모르는 사람의 정보는 획득할 수 없습니다.
3）URL 형식:

http://msdktest.qq.com/relation/wxprofile?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

struct WXInfo {
    string          nickName;       //닉네임만 반환하며, 비주가 필요한 것은 wxfriends_profile 인터페이스 호출
    int             sex;           //성별 1 남성 2 여성, 사용자가 입력하지 않으면 기본값 0
    string          picture;        //사용자 프로필 사진 URL에 뒤에 반드시 /0, /132, /96, /64와 같은 참수를 추가하여 다양한 크기의 이미지를 각각 획득할 수 있음: 본래 이미지(/0), 132*132(/132), 96*96(/96), 64*64(/64), 46*46(/46)
    string          provice;        //성(省)
    string          city;           //도시
    string          openid;         //사용자 표식
    string          country         //국가
    string          language       //언어
};

6) 예시:

POST /relation/wxprofile/?timestamp=*&appid=**&sig=***&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
{
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2Ccq_dcbciAvC8frI3gYk5d2p6pDFy-bOqyPTNysUxOQg",
    "openids": ["oGRTijrV0l67hDGN7dstOl8CphN0", "oGRTijlTxQPrvr-H5-pgoZMhZgog"]
}

//반환 결과
{
    "country": "CN",
    "language": "zh_CN",
    "lists": [
    {
        "city": "Shenzhen",
        "nickName": "헌터",
        "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
        "picture": "http://wx.qlogo.cn/mmhead/RpIhxf6qwjeF1QA6YxVvE8El3ySJHWCJia63TePjLSIc",
        "provice": "",
        "sex": 1
    },
    {
        "city": "Zhongshan",
        "nickName": "WeGame테스트",
        "openid": "oGRTijlTxQPrvr-H5-pgoZMhZgog",
        "picture": "",
        "provice": "",
        "sex": 2
    }
    ],
    "msg": "success",
    "privilege": [],
    "ret": 0
}

[위챗]친구 openid

1）인터페이스 이름: /relation/wxfriends
2）인터페이스 설명: 위챗 같은 게임 플레이 친구의 openid 목록 획득 시에는, 목록 획득 후에 /relation/wxprofile 인터페이스를 이용해 친구 기본 정보를 대량으로 검색할 수 있으며, 직접 wxfriends_profile 인터페이스를 사용할 것을 권장합니다.
3）URL 형식:

http://msdktest.qq.com/relation/wxfriends?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/wxfriends/?timestamp=*&appid=**&sig=**&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "openid": "oGRTijiaT-XrbyXKozckdNHFgPyc",
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJPLafWudG-idTVMbKesBkhaKJhRmjhioMlDM_zBq_SxfYO2jdJKzAR6DSHL5-02O6oATRKHf57K-teO6bPsB1RHjH5Z0I1TzMn4DllSYrf3Q"
}

//반환 결과
{
    "ret": 0,
    "msg": "success",
    "openids": ["oy6-ljtb1PKnNtRKlouJAj952hlg", "oy6-ljrzoW6jjxS2jI2LHZvGdsqA", "oy6-ljqJeurpVex1kyRAZl5blq3U", "oy6-ljoHSdnupQFMgHNTWoqSXXVg", "oy6-ljl-aYH1tl3L2clpVhhVXHtY"]
}

[위챗]개인 정보(비프리미엄 작업 상)

1）인터페이스 이름: /relation/wxuserinfo
2）인터페이스 설명: 위챗 개인 정보 획득은 “비 프리미엄 작업 사용”에 제공됩니다.
3）URL 형식:

http://msdktest.qq.com/relation/wxuserinfo?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/wxuserinfo/?timestamp=*&appid=**&sig=***&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg"
}

//반환 결과
{
    "city": "Shenzhen",
    "country": "CN",
    "msg": "success",
    "nickname": "xxx",
    "picture": "http://wx.qlogo.cn/mmopen/uQDECzzFUic3xMCxSqQwsgXZqgCB2MtscmicF20OGZiaKia6fMlqOLuGjlibiaUnVPk0GoGwkKWv2MIa8e4BSwXRHn7ia7zRn1bVz9E/0",
    "privilege": [],
    "province": "Guangdong",
    "ret": 0,
    "sex": "1",
    "unionid": "o1A_BjhwQHB2BUyasZ_Lb2rkkOpE"
}

[위챗]그룹 구성원 정보 확인

1）인터페이스 이름: /relation/wxget_groupinfo
2）인터페이스 설명: 길드 그룹 결합 완료 후, 해당 인터페이스를 호출해 사용자와 그룹 관계 정보를 확인할 수 있는 인터페이스. 사용자의 그룹 구성원 여부에 관한 정보를 반환할 수 있습니다.
3）URL 형식:

http://msdktest.qq.com/relation/wxget_groupinfo?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/wxget_groupinfo?timestamp=1507881410&appid=wxcde873f99466f74a&sig=b98ea62991568a72b09f7e2675014a6d&openid=oGRTijuUl6Peo6lybWyGQfNC9_WE&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 98

{
      "accessToken":"-2aMHhqC8Mmqsuw_1h3Fd_VRb232WayUbBmrtSnPNiHAOqvNN8oUU8tnMgkZOyEmcqpwDtMuyj63aeVywIAASg",
      "groupid": "110",
      "appid": "wxcde873f99466f74a",
      "openid": "oGRTijuUl6Peo6lybWyGQfNC9_WE",
      "openidlist": "oGRTijuUl6Peo6lybWyGQfNC9_WE"
}

//반환 결과

   {  "membercount":2,
      "msg":"success",
      "openidlist":"oGRTijuUl6Peo6lybWyGQfNC9_WE",
      "platCode":"",
      "ret":0
      }

[위챗]그룹 결합 해제

1）인터페이스 이름: /relation/wxunlink_group
2）인터페이스 설명: 위챗 그룹 결합 해제
3）URL 형식:

http://msdktest.qq.com/relation/wxunlink_group?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/wxunlink_group?timestamp=*&appid=**&sig=***&openid=**&encode=2 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJhKgRRgn5ztwrcCr1jwFWMow9ZDDD69U1GlL6tPS4GLX4nk6rIKoCEMz5ScKJ6bFmn0uT_eu0yhklQxkkhxjQS8v-ul7-ZEVHQleIchtSTyg",
    "groupid" : "2147521896"
}

//반환 결과
{
    "ret": 0,
    "msg":"success"
}

[위챗]그룹 상태 확인

1）인터페이스 이름: /relation/wxget_groupstatus
2）인터페이스 설명: 그룹 상태 확인
3）URL 형식:

http://msdktest.qq.com/relation/wxget_groupstatus?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/wxget_groupstatus?timestamp=*&appid=**&sig=***&openid=**&encode=2 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJhKgRRgn5ztwrcCr1jwFWMow9ZDDD69U1GlL6tPS4GLX4nk6rIKoCEMz5ScKJ6bFmn0uT_eu0yhklQxkkhxjQS8v-ul7-ZEVHQleIchtSTyg",
    "groupid": "2147521896",
    "op_type": 0
}

//반환 결과
{
    "ret": 0,
    "msg": "success",
    "is_has": 0
}

[위챗]그룹 메시지 발송

1）인터페이스 이름: /relation/wxsend_groupmsg
2）인터페이스 설명: 그룹 메시지 발송
3）URL 형식:

http://msdktest.qq.com/relation/wxsend_groupmsg?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

json 데이터 설명

데이터 json 형식: 
{
    "reqBody":{
        "msg_type" : 1, //int, 메시지 유형, 1: 구조화 공유 2: link 링크 공유 
        "sub_type" : 2, //int, 공유 유형, 초청1, 나눠갖기2, 선물3, 요청4
        "appid" : "wxa28d26b2e31a21c4", //string, 위챗 appid
        "groupid" : "mt2group", //string, 길드 id
        "open" : {
            "title" : "test1", //string, 메시지 title
            "desc" : "test2", //string, 메시지 소개
            "share_url" : "https://game.weixin.qq.com/cgi-bin/act?noticeid=90103953&actid=7006&k=Q6EgQ_8DgubBRXGb1vmTBw&q=0&jsapi_ticket=1&hongbaoid=8CF558E6633CCB020796260075B95465#wechat_redirect", //string, 이동 링크, msg_type이 1일 때는 보유할 필요 없음, msg_type이 2일 때는 반드시 보유해야 함
            "ext_info" : "test3", //string, 제 3자 프로그램은 간단한 데이터를 자체 정의하며, 위챗은 제 3자 프로그램에 회신하여 처리할 수 있고, 길이 제한은 2k, 클라이언트가 클릭할 때 이 필드를 획득할 수 있음
            "message_ext" : "test4", //string, 메시지 추가 필드
            "media_tag_name" : "test5", //string, 게임 메시지 유형을 구분하여 데이터 통계에 사용함
        }
    }
}

5) 반환 설명:

6) 예시:

POST /relation/wxsend_groupmsg?timestamp=*&appid=**&sig=***&openid=**&encode=2 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2AFUqpPDuHWnG-7zOK_CIkx0PWh694IgF0gRriiB4qj3A",
    "reqBody":{
        "msg_type" : 1,
        "sub_type" : 2,
        "appid" : "wxa28d26b2e31a21c4",
        "groupid" : "mt2group",
        "open" : {
            "title" : "test1",
            "desc" : "test2",
            "share_url" : "https://game.weixin.qq.com/cgi-bin/act?noticeid=90103953&actid=7006&k=Q6EgQ_8DgubBRXGb1vmTBw&q=0&jsapi_ticket=1&hongbaoid=8CF558E6633CCB020796260075B95465#wechat_redirect",
            "ext_info" : "test3",
            "message_ext" : "test4",
            "media_tag_name" : "test5",
        }
    }
}

//반환 결과
{
    "ret":0,
    "msg":"success",
    "platCode"：""
}

[위챗]미니앱 메시지 발송

1）인터페이스 이름: /relation/wx_mini_send_msg
2）인터페이스 설명: 위챗 백그라운드 미니앱 메시지 발송
3）URL 형식:

http://msdktest.qq.com/relation/wx_mini_send_msg?timestamp=&appid=&sig=&openid=&access_token=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /relation/wx_mini_send_msg?timestamp=**&appid=**&sig=**&openid=**&access_token=**&encode=2 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "touser":"oGRTijoPGCgg3PhIKcn5f4T30B5Q",
    "weapp_id":"wx4a0a73ec028e47d7",
    "path":"pages/main/main?v=123&t=1234",
    "env_version":"0",
    "pic_url":"wx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTKGKKZJsD7uySDq53Jtrppy2YPbt7YMxGrPjicZI4hynR9WWLoR9uxepMTUZWBdqNI0g8srfX9EIBg/0",
    "title" : "coin send to you",
    "media_tag_name":"MSG_INVITE"
}

//반환 결과
{
    "ret": 0,
    "msg": "success"
}

개인 정보

[모바일QQ]플레이어 실명 등록 후에 최초 로그인 표식 획득

1）인터페이스 이름: /profile/qqget_first_reg
2）인터페이스 설명: 플레이어 실명 등록 후에 최초 로그인 표식 획득
3）URL 형식:

http://msdktest.qq.com/profile/qqget_first_reg?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /profile/qqget_first_reg?timestamp=1510046500&appid=100703379&sig=b6080f45265d07fe5a48028cf59d8507&openid=061C8A0EC0E107B058960FBF2B3A3C41&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 77
{
    "accessToken":"0F6D3680BE37ADB831480D4D394F0614"
}
//반환 결과
{
    "ret":0,
    "msg":"success",
    "need_pop":"0",
    "realname_flag":"1",
    "mobile_flag":"1"

}

[모바일QQ]VIP 정보 획득

1）인터페이스 이름: /profile/query_vip
2）인터페이스 설명: QQ 계정 VIP 정보 획득(등록 상태 보유).
3）URL 형식:

http://msdktest.qq.com/profile/query_vip?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

flag 값 설명:

　　VIP_NORMAL(회원) = 1,
　　VIP_QQ_LEVEL(QQ 등급) = 2,  //QQ 등급은 level 파라미터에만 주의할 필요가 있으며 다른 건 무효임
　　VIP_BLUE(블루다이아몬드) = 4,
　　VIP_RED(레드다이아몬드) = 8, //레드다이아몬드는 연간 유료 회원 표식 반환이 없음
　　VIP_SUPER(슈퍼 회원) = 16,  //QQ 슈퍼 회원은 isvip만 유효임
　　VIP_XINYUE = 64,   //충성 클럽 특권 회원은 해당 표지 위치 요청 시에 isvip 및 level만 유효임
　　VIP_YELLOW = 128,  //옐로우다이아몬드 회원
    VIP_ANIMIC = 256,  //애니메이션 회원은 isvip만 유효임
    VIP_XINYUE_NEW = 512,  //충성 등급(새로운 인터페이스)

6) 예시:

POST /profile/query_vip?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
{
    "appid": "100703379",
    "openid": "A3284A812ECA15269F85AE1C2D94EB37",
    "vip": 512,
    "accessToken":"A3284A812ECA15A3284A812ECA15269F85AE1C2D94EB37269F85AE1C2D94EB37"
}
//반환 형식
{
    "ret": 0,
    "msg": "",
    "lists": [{
        "flag": 1,
        "year": 0,
        "level": 0,
        "luxury": 0,
        "isvip": 0
    },{
        "flag": 2,
        "year": 0,  
        "level": 10, 
        "luxury": 0, 
        "isvip": 1  
    },
    {
        "flag": 4,
        "year": 0,
        "level": 0,
        "luxury": 0,
        "isvip": 0
    },
    {
        "flag": 8,
        "year": 0,
        "level": 0,
        "luxury": 0,
        "isvip": 0
    },
    {
        "flag": 512,
        "year": 0,
        "level": 11,
        "luxury": 0,
        "isvip": 0
    }]
}

[모바일QQ]블루다이아몬드 선물

1）인터페이스 이름: /profile/get_gift
2）인터페이스 설명: 블루다이아몬드 선물 수령 후 1호 호출한 후 선물 삭제.
3）URL 형식:

http://msdktest.qq.com/profile/get_gift?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /profile/get_gift?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 77
{
    "appid": "100703379",
    "openid": "F4382318AFBBD94F856E866043C3472E"
}
//반환 결과
{
    "GiftPackList": [
        {
            "giftCount": "1",
            "giftId": "1001"
        }
    ],
    "msdkExtInfo": "testhunter",
    "msg": "success",
    "ret": 0
}

[모바일QQ]wifi 자격

1）인터페이스 이름: /profile/get_wifi
2）인터페이스 설명: 휴대 wifi 자격 획득.
3）URL 형식:

http://msdktest.qq.com/profile/get_wifi?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /profile/get_gift?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 77
{
    "appid": "100703379",
    "openid": "F4382318AFBBD94F856E866043C3472E"
}
//반환 결과
{
    "msg": "success",
    "ret": 0,
    "wifiVip": 1
}

[모바일QQ]성과 보고

1）인터페이스 이름: /profile/qqscore_batch
2）인터페이스 설명: 플레이어 성과를 QQ 플랫폼에 보고하고 QQ 게임 센터에서 친구의 점수 랭킹을 표시합니다. (실시간 효과로 해당 페이지를 통해 보고 성공 여부를 확인 가능: http://gpmmobile.oa.com/index.php?module=tools&action=query_achieve&func=query_achieve 비주: 권한이 없을 경우, 모바일QQ v_ruilunhu(후루이룬: 胡瑞伦)에게 연락해 신청하십시오.)
3）URL 형식:

http://msdktest.qq.com/profile/qqscore_batch?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST/profile/qqscore_batch?timestamp=1381288134&appid=100703379&sig=3f308f92212f75cd8d682215cb3fa8**&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 418
{
    "appid": "100703379",
    "accessToken": "E16A9965C446956D89303747C632C27B",
    "openid": "F4382318AFBBD94F856E866043C3472E",
    "param": [
        {
            "type": 3,
            "bcover": 1,
            "data": "999",
            "expires": "123459751"
        },
        {
            "type": 2,
            "bcover": 1,
            "data": "1999",
            "expires": "123459751"
        }
    ]
}

//반환 결과
{"msg":"success","ret":0,"type":0}

[모바일QQ]Tencent 동영상 회원 정보 획득

1）인터페이스 이름: /profile/qqget_video_vip
2）인터페이스 설명: 동영상 회원 정보 검색은 채널 유형에 따라 서로 다른 정보 필드를 반환합니다.
3）URL 형식:

http://msdktest.qq.com/profile/qqget_video_vip?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST/profile/qqget_video_vip?timestamp=1380018062&appid=100703379&sig=dc5a6330d54682c88846b1294fbd5f**&openid=F4382318AFBBD94F856E866043C3472E&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 418
{
    "appid": "100703379",
    "accessToken": "B8278F056B8E568DF7D2191EA67155A8",
    "openid": "1F4E29E9E0D326B159240865FD2441F1",
    "channel_id":30012,
    "timestamp":1506755367,
    "signature":"56495d9936d74da49a3a4b94fb6e9e71"
}

//반환 결과
{
    "ret":0,
    "msg":"OK",
    "annual_beg":1504242106,
    "annual_end":1531302428,
    "beg_time":1497261816,
    "end_time":1556186616,
    "is_annual":1,
    "service_type":"TXSP",
    "status":1,
    "vip_lv":4,
    "vip_score":3855
}

핵심 슈퍼 R 플레이어 회원 표식 획득(해당 인터페이스 GET 요청)

1）인터페이스 이름: /profile/get_xinyue_super
2）인터페이스 설명: 핵심 슈퍼 R 플레이어 회원 등급 정보 획득.
3）URL 형식:

http://msdktest.qq.com/profile/get_xinyue_super?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

GET
http://msdktest.qq.com/profile/get_xinyue_super?timestamp=1516607574&appid=100703379&sig=f5aa90f284adaf00173fe9e09a94f554&openid=E1FBBD6FCDC5D68B47A376FBE041D181&access_type=1&access_token=25600878E96CB97745BFC04C26E37891&trace_id=msdkdemo-E1FBBD6FCDC5D68B47A376FBE041D181-20180116155309-123456&encode=2 

//반환 결과
{
    "ret":0,"openid":"E1FBBD6FCDC5D68B47A376FBE041D181","ilevel":0,"trace_id":"msdkdemo-E1FBBD6FCDC5D68B47A376FBE041D181-20180116155309-123456","msg":"success"
}

핵심 위챗 플랫폼 플레이어 회원 표식 획득(해당 인터페이스 GET 요청)

1）인터페이스 이름: /profile/get_wx_xinyue_vip
2）인터페이스 설명: 핵심 위챗 플랫폼 플레이어 회원 등급 정보 획득.
3）URL 형식:

http://msdktest.qq.com/profile/get_wx_xinyue_vip?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

GET
http://msdktest.qq.com/profile/get_wx_xinyue_vip?timestamp=1521454585&appid=wxd477edab60670232&sig=3fe590a9a0308fcc29785db6b51d6655&openid=oKdX1jiB72W-4E16xBa5jFFEl-4g&encode=2&access_token=8_navsBc9yyjjABA_SWUTXgrRzrkDv562EG8-q15ZEz3ETKbZL52Z2rQexWaqitBD0eXespWD5PbI5hk2SNRBPtCg_2nX5_S_4j0wRBsF6jh0&serial=MSDK_20180327_181625_123456 

//반환 결과
{
    "ret":0,"ilevel":0,"serial":"MSDK_20180327_181625_123456","msg":"success."
}

[위챗]특권 획득

1）인터페이스 이름: /profile/wxget_vip
2）인터페이스 설명: 위챗 특권 획득
3）URL 형식:

http://msdktest.qq.com/profile/wxget_vip?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

vipinfo 설명

//vipinfo 데이터 배열 중 첫 항목 기록 기본값은 요청자이며, 친구는 그 뒤에 배열됨. 데이터가 없을 경우 data는 공백이 됨
    "vipinfo": [    
        {
            "openid": "xxx",
            "level": 1,            //등급
            "score": 310,          //점수
            "nick": "VIP1",        //vip 이름
            "logo_url": "xxxx",    //vip logo 이미지 url
            "logo_faceurl": "xxx"  //프로필 사진 삽입 vip logo 이미지 url에 사용
            //logo_url 및 logo_faceurl 파라미터 현재 사용 불가, 주의할필요 없음
        },
                {
            "openid": "xxx",
            "level": 0,
            "score": 0,
            "nick": "VIP0",
            "logo_url": "xxxx",
            "logo_faceurl": "xxx"
        }
    ]

6) 예시:

POST /profile/wxget_vip?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5fde&openid=A3284A812E%20CA15269F85AE1C2D94EB37&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 298

{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg",
    "json": {
        "optype": 1
    }
}

//반환 결과
{
    "msg": "success",
    "ret": 0,
    "data":{
        "vipinfo": [
            {
                "openid": "xxx",
                "level": 1,            
                "score": 310,        
                "nick": "VIP1",        
                "logo_url": "xxxx", 
                "logo_faceurl": "xxx" 
            },
            {
                "openid": "xxx",
                "level": 0,
                "score": 0,
                "nick": "VIP0",
                "logo_url": "xxxx",
                "logo_faceurl": "xxx"
            }
        ]
    }
}

[위챗]플레이어 실명 등록 후에 최초 로그인 표식 획득

1）인터페이스 이름: /profile/wxget_first_reg
2）인터페이스 설명: 플레이어 실명 등록 후에 최초 로그인 표식 획득.
3）URL 형식:

http://msdktest.qq.com/profile/wxget_first_reg?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /profile/wxget_first_reg?timestamp=1510046500&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5f&openid=A3284A812E%20CA15269F85AE1C2D94EB37&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 77
{
    "accessToken":"OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg"
}
//반환 결과
{
    "ret":0,
    "msg":"success",
    "need_pop":"0",
    "realname_flag":"1",
    "mobile_flag":"1"

}

[위챗]Tencent 동영상 회원 정보 획득

1）인터페이스 이름: /profile/wxget_video_vip
2）인터페이스 설명: 동영상 회원 정보 검색은, 채널 유형에 따라 다양한 정보 필드를 반환합니다.
3）URL 형식:

http://msdktest.qq.com/profile/wxget_video_vip?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST/profile/wxget_video_vip?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5f**&openid=A3284A812E%20CA15269F85AE1C2D94EB37&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 418
{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijv68W77PGpmk-SGvao2pBpY",
    "channel_id":30012,
    "timestamp":1506755218,
    "signature":"7d1dc4341ab21b68c57fe4e14f70d602"
}

//반환 결과
{
    "ret":0,
    "msg":"OK",
    "annual_beg":0,
    "annual_end":0,
    "beg_time":1487524745,
    "end_time":1487704961,
    "is_annual":0,
    "service_type":"",
    "status":0,
    "vip_lv":0,
    "vip_score":0
}

[위챗]성과 보고

1）인터페이스 이름: /profile/wxbattle_report
2）인터페이스 설명: 게임 성적 정보(점수, 전투 등)를 위챗 게임 센터에 보고하며, 보고 시기는 매 시합 당, 매 스테이지 당, 또는 매 라운드 클리어 후의 시점이 되거나 게임에서 자체 정의한 합리적인 보고 시간이 됩니다. 어떤 데이터를 위챗 플랫폼(hugozhou, johnnyliu) 측에서 보고하도록 요청할 지에 대해서는, 양측이 소통을 통해 합의한 후에 다시 보고합니다. <비행기 대전>(《全民飞机大战》)을 예로 들면, 금화, 체력은 게임의 맞춤 데이터에 속하며, 점수를 선택해 위챗 친구 순위 자료(되도록 같은 게임에서 같도록 유지)로 삼습니다.
3）URL 형식:

http://msdktest.qq.com/profile/wxbattle_report?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

json 데이터 설명

보고 데이터 json 형식(단일 사용자 데이터):
{
    "baseinfo": {
        "gamename":"비행기 대전(全民飞机大战)", //문자열 형식, 게임 이름, 입력 권장
        "platid": 0, //정수 형식, 플랫폼 유형: iOS 1 :Andriod 필수 입력
        "partitionid": "9", //문자열 형식, 분류 구역ID, 게임에 분류 구역 개념이 없을 경우 이 항목은 생략 가능하며, 있는 경우에는 입력할 것을 권장
        "roleid": "wongcai", //문자열 형식, 캐릭터 ID, 게임에 캐릭터 개념이 없을 경우 이 항목은 생략 가능하며, 있는 경우에는 입력할 것을 권장
        "level": 2 //정수 형식, 사용자 등급, 게임에 등급 개념이 없을 경우 이 항목은 생략 가능하며, 있는 경우에는 입력할 것을 권장
    },
    "battleinfo": {
        "score": 4288625, //정수 형식, 해당 수치는 위챗 게임 순위에 영향을 미치며, 필수 입력 항목은 아니지만 해당 데이터가 없으면 순위가 없음(<비행기 대전>(全民飞机大战)을 예로 들면, 해당 항목은 게임 내 획득 점수를 입력)
        "iswin": true //불 방식, 현재 승패 상황, 적용되는 보드 유형, 게임에 승리 개념이 없을 경우 이 항목은 생략 가능하며, 있는 경우에는 입력할 것을 권장
    },
    "userdefined": { //게임 자체 정의 데이터, 플랫폼 측에서 보고를 요구하며, 게임 측에서는 현재 자체적으로 보고해야 함. 예를 들어 플랫폼에서 <비행기 대전>의 금화, 체력, 전투기 등 자체 정의 데이터를 보고하도록 요구할 경우, 그중에서 value 유형은 일반적으로 정수 형식 또는 문자열 형식이 됨: 
        "goldcoin": { //자체 정의 데이터 ID1
            "name": "금화", //문자열 형식, 데이터 이름
            "value": 358267, //정수 형식, 데이터 수치
        },
        "power": { //자체 정의 데이터 ID2
            "name": "체력", //문자열 형식, 데이터 이름
            "value": 86542, //정수 형식, 데이터 수치
        },
        "plane": { //자체 정의 데이터 ID3
            "name": "전투기", //문자열 형식, 데이터 이름
            "value": "블레이징 엔젤", //문자열 형식, 데이터 내용
        },
        //자체 정의 데이터는 계속해서 확장 가능
     }
}
//동시에 멀티 사용자 대량 데이터를 지원하며 이상의 여러 단일 배열을 json 데이터 배열 형식으로 조합 구성할 수 있습니다.: [{사용자 데이터1}, {사용자 데이터2},...]

5) 반환 설명:

6) 예시:

POST /profile/wxbattle_report?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5fde&openid=A3284A812E%20CA15269F85AE1C2D94EB37&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 372
{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "json":{
        "baseinfo": { 
            "gamename": "xxx",
            "platid": 0,
            "partitionid": "9",
            "roleid": "hunter",
            "level": 2 
        },
        "battleinfo": {
            "score": 4288625,
            "iswin": true
        }
    }
}

//반환 결과
{
    "msg": "success",
    "ret": 0
}

[위챗]메시지 예약

1）인터페이스 이름: /profile/subscribe_getlist
2）인터페이스 설명: 메시지 예약 목록
3）URL 형식:

http://msdktest.qq.com/profile/subscribe_getlist?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

subscribeList 설명:

"subscribeList": [
    {
        "id": 19,            //메시지 id
        "title": "2111",        //메시지 제목
        "status": false        //예약 여부: true 예약됨 false: 예약 없음
    },
    {
        "id": 43,
        "title": "test_msg",
        "status": false
    }
]

6) 예시:

POST /profile/subscribe_getlist?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5fde&openid=A3284A812E%20CA15269F85AE1C2D94EB37&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 257
{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg"
}

//반환 결과
{
"ret":0,
"msg":"success",
"subscribeList": [
    {
        "id": 19,            //메시지 id
        "title": "2111",        //메시지 제목
        "status": false        //예약 여부: true 예약됨 false: 예약 없음
    },
    {
        "id": 43,
        "title": "test_msg",
        "status": false
    }
],
"more": false
}

[위챗]대규모 예약

1）인터페이스 이름: /profile/subscribe_setlist
2）인터페이스 설명: 대규모 예약 설정
3）URL 형식:

http://msdktest.qq.com/profile/subscribe_setlist?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST http://msdktest.qq.com/profile/subscribe_setlist?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5fde&openid=A3284A812E%20CA15269F85AE1C2D94EB37&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 293
{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg",
    "msgId": [77],
    "opType": 1
}

//반환 결과
{
"ret":0,
"msg":"success"
}

[위챗]예약 푸시

1）인터페이스 이름: /profile/subscribe_push
2）인터페이스 설명: 메시지 푸시 예약으로 모든 예약된 사용자에게 푸시 전송
3）URL 형식:

http://msdktest.qq.com/profile/subscribe_push?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /profile/subscribe_getlist?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5fde&openid=A3284A812E%20CA15269F85AE1C2D94EB37&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 101

{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "msgId": 77
}

//반환 결과
{
"ret":0,
"msg":"success"
}

[위챗]예약 삭제

1）인터페이스 이름: /profile/subscribe_clear
2）인터페이스 설명: 메시지 예약 사용자 삭제
3）URL 형식:

http://msdktest.qq.com/profile/subscribe_push?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /profile/subscribe_getlist?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5fde&openid=A3284A812E%20CA15269F85AE1C2D94EB37&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 101

{
    "appid": "wxcde873f99466f74a",
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "msgId": 77
}

//반환 결과
{
    "ret":0,
    "msg":"success"
}

[위챗]엘리트 검색

1）인터페이스 이름: /profile/wxget_eliteinfo
2）인터페이스 설명: 위챗 엘리트 사용자 인터페이스 검색
3）URL 형식:

http://msdktest.qq.com/profile/wxget_eliteinfo?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /profile/wxget_eliteinfo?timestamp=1380018062&appid=xxxxxxxxxx&sig=dc5axxxxxxxxxxxxxx94fbd5fde&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 176
{
    "accessToken": "OezXcEiiBSKSxW0eoylIeLl3C6Ogxxxxxxxxxxxxxxxxxxxxxpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg"
}

//반환 결과
{
    "ret":0,
    "msg":"success",
    "data": {
        "wx_elite": 0,        //0 사용자가 위챗 엘리트가 아님, 1 사용자가 위챗 엘리트임
        "game_elite": 0        //0 사용자가 게임 엘리트가 아님, 1 사용자가 게임 엘리트임   
    }
}

공유

모바일QQ 및 모바일 Qzone의 방향 지정 공유 능력을 제공합니다.

[모바일QQ]백그라운드 공유

1）인터페이스 이름: /share/qq
2）인터페이스 설명: P2P 방향 지정 공유(메시지를 모바일QQ 친구와 공유하고 공식 계정 “QQ 모바일 게임” 상에 표시).
비주: 공유하는 콘텐츠는 모바일QQ 상에 있어야 볼 수 있으며, PC QQ 상에서는 볼 수 없습니다. 수신자 측에서 “QQ 모바일 게임” 공공 계정에 주의를 기울여야 수신할 수 있으며, 동일한 사용자가 매일 최대 5건을 받을 수 있고, 동일한 사용자에게서 수신하는 것은 매일 최대 3건입니다.
모바일QQ 백엔드 공유는 새로운 액세스 절차를 제공하며, 새 게임 액세스 시에 다음 절차에 따라 액세스(이미 온라인된 게임에 영향 없음)하며, 다음 절차는 모두 Tencent의 대응하는 인터페이스 인원에게 연락해 도킹해야 합니다.
(1) 백엔드 공유 권한 개통 신청
(2) 이미지 및 문안을 v_diqicai(蔡迪琪: 차이디치)에 제공
(3) appid 및 gametag를 AMS 절차에 새롭게 추가하고, v_diqicai(蔡迪琪: 차이디치)에 연락해 등록
(4) v_diqicai(蔡迪琪: 차이디치)에 연락해 1개의 테스트용 게임 센터 상세 정보 페이지(이후에 정식 상세 정보 페이지로 수정 가능)
(5) 인터페이스 액세스 완료 후 공유 성공 여부 검증
3）URL 형식:

http://msdktest.qq.com/share/qq?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST 
/share/qq?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5fde&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{
    "act": 1,
    "oauth_consumer_key": xxxxxx,
    "dst": 1001,
    "flag": 1,
    "image_url": "http://mat1.gtimg.com/www/images/qq2012/erweimaVideoPic.png",
    "openid": "A3284A812ECA15269F85AE1C2D94EB37",
    "access_token": "933FE8C9AB9C585D7EABD04373B7155F",
    "src": 0,
    "summary": "개요",
    "target_url": "http://gamecenter.qq.com/gcjump?appid={YOUR_APPID}&pf=invite&from=iphoneqq&plat=qq&originuin=111&ADTAG=gameobj.msg_invite
",
    "title": "test by hunter",
    "fopenids": [{"openid":"69FF99F3B17436F2F6621FA158B30549","type":0}],//json 데이터 배열
    "previewText": "나는 매일 게임을 즐겨요"
}

//반환 결과
{"ret":0,"msg":"success"}

7) 반환 코드 설명:

[위챗]그림 업로드 공유

1）인터페이스 이름: /share/upload_wx
2）인터페이스 설명: Tencent에서 상응하는 제품을 페이잉(飞鹰) 시스템 을 통해 이미지를 위챗에 업로드하고 media_id를 획득해 /share/wx 인터페이스의 입력 파라미터 thumb_media_id에 사용하고, 공유 시에 사용한 기본 이미지(app 등록 시 업로드한 icon)인 경우, 해당 인터페이스를 호출하지 않아도 되며, thumb_media_id=""이면 됩니다. (해당 인터페이스는 매회 공유 시마다 호출할 필요는 없으며, 공유 시에 이미지를 교체할 때에만 1회 media_id를 획득하면 되고, 이후에 /share/wx 인터페이스 호출 시에 이미 획득한 media_id를 직접 입력합니다.)
주의: 해당 인터페이스를 통해 획득한 media_id는 Android 시스템 위챗 5.4-6.1 버전에서 무효(운영 관리자가 기본값 icon을 재업로드해 해결)이며, Android 위챗 6.2 버전에서는 해당 문제가 해결되었습니다.

(./res/server_share.png)

3) URL 형식:

http://msdktest.qq.com/share/upload_wx?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

$filename = 'b.jpg';
$image = './image/'.$filename;
$handle = fopen($image,'r');
$filelength = filesize($image);//문자열
$contents=fread($handle,filesize($image));
$binary = rawurlencode($contents);
Java 내 코딩에 주의: “ISO-8859-1”, 예: URLEncoder.encode(new String(bs, "ISO-8859-1"), "ISO-8859-1");

5) 반환 설명:

6) 예시:

POST /share/upload_wx?timestamp=1380018062&appid=xxxxxxxxxxx&sig=xxxxxxxxxxxx&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198

{"flag":1,"appid":"xxxxxxxxxxxxxx","secret":"xxxxxxxxxxxxxxxxxxxxx","access_token":"","type":"thumb","filename":"b.jpg","filelength":65050,"content_type":"image\/jpeg","binary":"%FF%D8%FF%E0%00%10JFIF%00%01%01%01%00%60%00%60%00%00%FF%DB%00C%00%03%02%02%03%02%02%03%03%03%03%04%03%03%04%05%08%05%05%04%04%05%0A%07%07%06%08%0C%0A%0C%0C%0B%0A%0B%0B%0D%0E%12%10%0D%0E%11%0E%0B%0B%10%16%10%11%13%14%15%15%15%0C%0F%17%18%16%14%18%12%14%15%14%FF%DB%00C%01%03%04%04%05%04%05%09%05%05%09%14%0D%0B%0D%14%14%14%...."}

//반환 결과
{
    "ret": 0,
    "msg": "success",
    "type": "thumb",
    "media_id": "CAUmtmwCq6jSGWaypYRzJRpErL-vUZj8UPeU8UupzyMFGGpmOnkeUDGLLI9RiTqN",
    "created_at": "1379579554",
    "access_token": "avl-4_K9aZ7MY88Tb-FKfCt3LNvsFkkCXGErRmX7tn19iqw0p45nGjB76tdRfhfi-7oWAQr8ZbvwC1EuWx_f8m5-A0kNNhEC7HAaePUokAtb6xGgRGyyAkoftjlk42sp4OSVJCgkuwWvithft4a00Q",
    "expire": ’’
}

[위챗]백그라운드 공유

1）인터페이스 이름: /share/wx
2）인터페이스 설명: 공유 메시지를 위챗 친구(동일한 게임을 설치한 친구에게만 가능)에게 발송합니다.

3) URL 형식:

http://msdktest.qq.com/share/wx?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /share/wx?timestamp=1380018062&appid=wxcde873f99466f74a&sig=dc5a6330d54682c88846b1294fbd5fde&encode=2 HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
{
    "openid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "fopenid": "oGRTijrV0l67hDGN7dstOl8CphN0",
    "access_token": "OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2BZMgzJc8KWgXT8uGw242GeNigmf9VQCouPmZ9ciBE4MA",
    "extinfo": "extinfo",
    "title": "to myself",
    "description": "test by hunter",
    "media_tag_name": "media_tag_name",
    "thumb_media_id": ""
}

//반환 결과
{"ret":0,"msg":"success"}

[위챗]위챗 백엔드 공유 링크 메시지

1）인터페이스 이름: /share/wx_link
2）인터페이스 설명: 위챗 백엔드 공유 링크 메시지로, 위챗 클라이언트를 불러오지 않은 환경 하에서 url을 친구와 공유할 수 있습니다.

3) URL 형식:

http://msdktest.qq.com/share/wx_link?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /share/wx_link?timestamp=1521800711&appid=wxcde873f99466f74a&sig=cd435fceebb9009b23cd09c9766d8e9a&encode=2&openid=oGRTijg1fJI6rO5ACReNhUocv4YA HTTP/1.0
Host:msdktest.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
{
    "access_token": "8_xBp8ztqWwDRmbccjNAG_xPcy3OszjO9tobb_myr8yjS49xUVJsqmZdeiKRFS62hbsbplor15vs2uevp7lyxaYg",
    "touser": "oGRTijg1fJI6rO5ACReNhUocv4YA",
    "title": "title, wx link",
    "description": "test by msdk 나",
    "url": "http://wiki.msdk.qq.com/",
    "thumb_url": "http://wiki.msdk.qq.com/Unity/res/share_struct_qq.png"
}

//반환 결과
{"ret":0,"msg":"success"}

자유 스트림

자유 스트림 확인

1）인터페이스 이름: /freeflow/getinfo
2）인터페이스 설명: openid에 근거해 해당 사용자의 자유 스트림 정보를 확인하고, MSDK 백그라운드는 사용자의 구매 관계에 근거하여 상응하는 자유 스트림 정보를 반환합니다.

3) URL 형식:

http://msdktest.qq.com/freeflow/getinfo?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /freeflow/getinfo/?timestamp=1104680867&appid=110***&sig=***&openid=23F7F96A4920872EA3CA2DB6CB8EFE04&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded

//반환 결과
{
    "ret": 0,
    "msg": "success",
    "freeFlowInfo": {
    "ipList": "***",
    "isFree": 1,
    "ccType": 1,
    "ltList": "***",
    "dxList": "***",
    "ydList": "***",
    "expire": 3600
    }
}

ip 정보 검색

1）인터페이스 이름: /freeflow/get_ccinfo
2）인터페이스 설명: 입력 ip 또는 클라이언트 ip에 근거해 운영 업체, 지역 등 해당 ip의 상세 정보를 검색합니다.

3) URL 형식:

http://msdktest.qq.com/freeflow/get_ccinfo?timestamp=&appid=&sig=&openid=&encode=2

4) 입력 파라미터 설명:

5) 반환 설명:

6) 예시:

POST /freeflow/get_ccinfo/?timestamp=1104680867&appid=110***&sig=***&openid=23F7F96A4920872EA3CA2DB6CB8EFE04&encode=1&ip=59.37.125.72 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded

//반환 결과
{
    "ret": 0,
    "msg": "success",
    "data": {
    "apn": "unknown",
    "city": "션전시",
    "country": "중국",
    "district": "난샨구",
    "extend": "unknown",
    "nettype": "unknown",
    "oper": "차이나 텔레콤,
    "province": "광동성"
    }