12/12/2024 11:37:56

登录鉴权

一、鉴权

1.1 接口名

/v2/auth/verify_login

1.2 请求参数

1.3 返回参数

1.4 请求示例

• 请求：

    {
        "openid":"4724195171999796436",
        "token":"27A50B44430AAD6BFFBE09BA875E48BB"
    }
  

• 返回:

    {
        "ret":0,
        "msg":"user is logged in.",
        "seq":"123"
    }
  

注意：
1、PC SDK 形式授权，需要在 json body 中新增 "client_os":5，详情如下；

    {
        "openid":"14100430050145592702",
        "token":"cfidt26Wg-QDc5PoDqglJxzOrw9H0hmTn0At4nK3lAP5vpvPAl1AxHMzvHM89tN6u5v9pmns8ZcCYU3f1DBBheHnVYYo940MXs5rXZpZ8S4loYpoRdaXmDhT2zPFYsDD0a9IrQdrHbzAu7IGz4MGAGuMs8y1p10PMyJpDkEa7tRm8wngXuoHFA",
        "client_os":5
    }

2、PC Web 形式授权获取的 token 与手游授权获取的 token 类型一致。接入方在进行服务端鉴权的时候务必确认 json body 中无需额外传递 "client_os":5，同时 请求 URL 中的 os 字段不要传入 5，否则会造成鉴权失败。

二、解密校验

2.1 接口名

/v2/auth/decrypt（该接口为 GET 请求）

2.2 请求参数

2.3 返回参数

成功返回 itopencodeparam 解密后的明文，失败则返回 JSON 串，字段如下：

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
  

三、获取pf和pfkey

3.1 接口名

/v2/auth/get_pfval

3.2 请求参数

3.3 返回参数

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"
    }