04/28/2025 20:45:30

계정 호환 인터페이스

1 제3자 채널 계정id 조회

1.1 인터페이스 이름

/v2/profile/openid2uid

1.2 요청 파라미터

1.3 리턴 파라미터

1.4 요청 예시

• 요청

    curl -X POST 'https://hktest.itop.qq.com/v2/profile/openid2uid?channelid=1&gameid=12&os=2&source=0&ts=1543583577&sig=71fbf808db338a4733c194cfd0fbc0bc' -d '{"token": "16__7PhV9W6PeKtH0yW4Bs6fMwn8wYJgtwluX6_sLwxN8dfCSYajqtWUW3JPaOp170nSZNOvpr2zHHRmiERbPwmQqwrtB6nKwk0v-GhJ9JwXcg", "openid": "10259875237126117000"}'
  

• 응답

    {
        "ret": 0,
        "msg": "success",
        "openid": "10259875237126117000",
        "uid": "oHlap1Rcz0d6svU4cwah-c0L3OzQ",
        "seq":"1578039139-0268717065-004704-0000087756"
    }
  

• 요청

    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/openid2uid?channelid=2&conn=&gameid=12&os=1&seq=&source=0&ts=1578039002&version=2.0&sig=0e1721c469920ed08a4e9c37678537b8' -d '{"openid":"15879468368890148661","token":"D46EF700A328F58231FF69045A54C91D","f_openid":"7596233514244205937"}'
  

• 응답

    {
        "ret": 0,
        "msg": "success",
        "openid": "7596233514244205937",
        "uid": "255E40A981DF206E75975A7440098C1D",
        "seq": "1578039046-0268717065-004704-0000087754"
    }
  

2 통합 계정id 조회

2.1 인터페이스 이름

/v2/profile/uid2openid

2.2 요청 파라미터

2.3 리턴 파라미터

2.4 요청 예시

• 요청

    curl -X POST 'https://hktest.itop.qq.com/v2/profile/uid2openid?channelid=1&gameid=12&os=2&source=0&ts=1543584407&sig=6077c1a5de15a3c5e9bcdbedec2928f8' -d '{"token": "6srOlTx3YVgpNCjf5wndaT8em6PUA0QEs77OwXbIgBLoTEhbJxgoDevhrp2uxcH8", "uid": "oHlap1Rcz0d6svU4cwah-c0L3OzQ"}'
  

• 응답

    {
        "ret": 0,
        "msg": "success",
        "openid": "10259875237126117000",
    }
  

3 제3자 채널 계정ID 조회（token 없음, source 제한）

3.1 인터페이스 이름

/v2/profile/openid2uid_notoken

3.2 사용 설명

token 없음：본 인터페이스는 내부에 token 이 없는 컴포넌트에만 사용；

source 제한：각 컴포넌트는 1개의 source 를 대응하며, 신규 접속은 source 에서 요청하여야 본 인터페이스를 사용할 수 있음；source 요청과 관련하여 MSDK도우미 에 연락；

3.3 요청 파라미터

3.4 리턴 파라미터

3.5 요청 예시

• 요청

    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/openid2uid_notoken?channelid=9&gameid=11&os=1&seq=&source=0&ts=1558666012&version=2.0&sig=5f9d773fa560bf76ca07c9fd82f76e43' -d '{"openid":"6654814801566087952"}'
  

• 응답

    {"ret":0,"msg":"success","uid":"1112070588"}
  

4 통합 계정 ID 조회（token 없음, source 제한）

4.1 인터페이스 이름

/v2/profile/uid2openid_notoken

4.2 사용 설명

token 없음：본 인터페이스는 내부에 token 이 없는 컴포넌트에만 사용；

source 제한： 컴포넌트는 1개의 source 를 대응하며, 신규 접속은 source 에서 요청하여야 본 인터페이스를 사용할 수 있음；source 요청과 관련하여 MSDK도우미 에 연락；

4.3 요청 파라미터

4.4 리턴 파라미터

4.5 요청 예시

• 요청

    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/uid2openid_notoken?channelid=9&gameid=11&os=1&seq=&source=0&ts=1558666012&version=2.0&sig=06c4fd21e8f27d3da2f89ee0bcf77e49' -d '{"uid":"1112070588"}'
  

• 응답

    {"ret":0,"msg":"success","openid":"6654814801566087952"}
  

5 제3자 채널 token 획득

5.1 인터페이스 이름

/v2/profile/exchange_channel_token（해외 채널에서만 사용 가능）

5.2 요청 파라미터

5.3 리턴 파라미터

5.4 요청 예시

• 요청

    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/exchange_channel_token?channelid=9&gameid=11&os=1&seq=&source=0&ts=1558666012&version=2.0&sig=e6b72b5ad42aaed268eae5a31b950630' -d '{"openid":"6654814801566087952","token":"91c538ff9ea265af2814f35e4e72d5032178d46f"}'
  

• 응답

    {"ret":0,"msg":"success","channel_token":"1112070588-zlaMZWcXi1qClE4P0Kphux3Q90PapSy0u6PworD"}
  

6 AppID 획득

6.1 인터페이스 이름

/v2/comm/get_appid

6.2 요청 파라미터

비어있는 json 객체 입력

6.3 리턴 파라미터

6.4 요청 예시

• 요청

    curl -X POST -H 'Content-Type: application/json' 'https://dev.itop.qq.com/v2/comm/get_appid?channelid=2&gameid=11&os=1&seq=&source=0&ts=1559121639&version=2.0&sig=69de2d7c4225136095f5f15418d60087' -d '{}'
  

• 응답

    {"ret":0,"msg":"success","appid":"1106977030"}