前言#

终末地仅可在游戏中获取寻访记录，所以我们需要抓包来进行逆向。

登录#

登录目前有以下几种：

验证码，密码，扫码

验证码登录#

1
POST https://as.hypergryph.com/general/v1/send_phone_code

请求体#

1
{
2
  "phone": "这里是手机号",
3
  "type": 2
4
}

返回内容（成功）#

1
{
2
  "msg": "OK",
3
  "status": 0,
4
  "type": "A"
5
}

返回内容（频繁）#

1
{
2

3
    "msg": "发送频率太高，请稍后再试",
4

5
    "status": 102,
6

7
    "type": "C1"
8

9
}

获取Token#

1
POST https://as.hypergryph.com/user/auth/v2/token_by_phone_code

请求头#

X-DeviceId	随机数字/字母，长度不限，建议10字符左右
X-DeviceModel	随机数字/字母，设备名
X-DeviceType	2

请求体#

1
{
2
  "appCode": "dd7b852d5f1dd9da",
3
  "code": "验证码",
4
  "phone": "手机号"
5
}

响应体#

1
{
2
  "data": {
3
    "token": "这里是token",
4
    "hgId": "这里是hgid",
5
    "deviceToken": "这里是设备token"
6
  },
7
  "msg": "OK",
8
  "status": 0,
9
  "type": "A"
10
}

密码登录#

1
POST https://as.hypergryph.com/user/auth/v1/token_by_phone_password

请求体#

不知道为什么，没做加密

1
{
2
  "password": "密码",
3
  "phone": "手机号"
4
}

响应体#

1
{
2
  "data": {
3
    "token": "头肯"
4
  },
5
  "msg": "OK",
6
  "status": 0,
7
  "type": "A"
8
}

但问题来了，我们无法获取到设备token。

疑似新设备登录必须使用验证码，因为只有验证码接口才会返回设备Token.

而验证码返回的设备token可以在下一步使用密码获取的token来得到code

也就是验证码获取设备token，密码获取token，获取code需要设备token与token

那为什么不直接验证码登录呢。。

扫码登录#

获取二维码#

1
POST https://as.hypergryph.com/general/v1/gen_scan/login

请求体#

1
{
2
  "appCode": "dd7b852d5f1dd9da"
3
}

响应体#

1
{
2
  "data": {
3
    "scanId": "此次登录ID",
4
    "scanUrl": "hypergryph://scan_login?scanId=12345",
5
    "enableScanAppList": [
6
      {
7
        "appCode": "4ca99fa6b56cc2ba",
8
        "name": "森空岛",
9
        "iconUrl": "https://web.hycdn.cn/biz_toolset/upload/251225/qYm0f7X8LMaLkRRL.jpg"
10
      },
11
      {
12
        "appCode": "dd7b852d5f1dd9da",
13
        "name": "明日方舟：终末地",
14
        "iconUrl": "https://web.hycdn.cn/biz_toolset/upload/251225/7ms6XmvZH1GfZT11.jpg"
15
      }
16
    ]
17
  },
18
  "msg": "OK",
19
  "status": 0,
20
  "type": "A"
21
}

注意到，scanUrl并不是普通的url，而是内部链接，我们需要生成这个链接的二维码扫码，生成的二维码格式为文本哦

轮询二维码状态#

1
GET https://as.hypergryph.com/general/v1/scan_status?scanId=这里是上一步的scanId

响应体（未扫码）#

1
{
2
  "msg": "未扫码",
3
  "status": 100,
4
  "type": "A"
5
}

响应体（已扫码）#

1
{
2
  "data": {
3
    "scanCode": "asdasfasdasodasdasd"
4
  },
5
  "msg": "OK",
6
  "status": 0,
7
  "type": "A"
8
}

通过scanCode获取Token#

1
POST https://as.hypergryph.com/user/auth/v1/token_by_scan_code

请求头#

X-DeviceId	随机数字/字母，长度不限，建议10字符左右
X-DeviceModel	随机数字/字母，设备名
X-DeviceType	2

请求体#

1
{
2
  "appCode": "dd7b852d5f1dd9da",
3
  "from": 0,
4
  "scanCode": "上一步的"
5
}

响应体#

1
{
2
  "data": {
3
    "token": "token",
4
    "hgId": "这是啥我也不知道",
5
    "deviceToken": "设备token"
6
  },
7
  "msg": "OK",
8
  "status": 0,
9
  "type": "A"
10
}

人机验证#

在登陆时，有概率风控，以手机号登录为例：

请求发送验证码时，返回：

1
{
2
    "data": {
3
        "captcha": {
4
            "challenge": "123",
5
            "success": 1,
6
            "gt": "123",
7
            "new_captcha": true
8
        }
9
    },
10
    "msg": "需要人机验证",
11
    "status": 1,
12
    "type": "A"
13
}

那么我们需要进行人机验证，然后再次请求。

鹰角使用的geetest提供的人机验证服务

那么我们可以写一个HTML页面，来接入后获取验证完毕的参数

1
<!doctype html>
2

3
<html lang="en">
4

5
  <head>
6

7
    <script src="https://static.geetest.com/static/js/gt.0.5.0.js"></script>
8

9
    <meta charset="UTF-8" />
10

11
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
12

13
    <title>Document</title>
14

15
  </head>
16

17
  <body>
18

19
    <div id="captcha-box"></div>
20

21
  </body>
22

23
  <footer>
24

25
    <script>
26

27
      var captchaBox = document.getElementById("captcha-box");
28

29
      setTimeout(() => {
30

31
        initGeetest(
32

33
          {
34

35
            // 以下配置参数来自服务端 SDK
36

37
            gt: "上文的gt",
38

39
            challenge: "上文的challenge",
40

41
            offline: false,
42

43
            new_captcha: true,
44

45
            api_server: "api.geevisit.com", //非必须参数，添加此字段用于修改极验api域名
46

47
          },
48

49
          function (captchaObj) {
50

51
            captchaObj.appendTo(captchaBox);
52

53
            captchaObj.onSuccess(function () {
54

55
              var result = captchaObj.getValidate();
56

57
              console.log(result)
58

59
            });
60

61
          },
62

63
        );
64

65
      }, 1000);
66

67
    </script>
68

69
  </footer>
70

71
</html>

当验证完毕后，控制台会返回

1
{
2

3
        "geetest_challenge": "123",
4

5
        "geetest_validate": "456",
6

7
        "geetest_seccode": "789|asd"
8

9
}

你也可以自行修改以下函数来自定义：

1
            captchaObj.onSuccess(function () {
2

3
              var result = captchaObj.getValidate();
4

5
              console.log(result)
6

7
            });

只是提供思路，不要照抄哦

我们需要将控制台返回的三个字段加入发送验证码的请求中重新发送即可

1
{
2

3
    "phone": "手机号",
4

5
    "type": 2,
6

7
    "captcha": {
8

9
        "geetest_challenge": "123",
10

11
        "geetest_validate": "456",
12

13
        "geetest_seccode": "789|asd"
14

15
    }
16

17
}

Token获取Code#

1
POST https://as.hypergryph.com/user/oauth2/v2/grant

请求体#

1
{
2

3
  "appCode": "dd7b852d5f1dd9da",
4

5
  "deviceToken": "上一步的设备token",
6

7
  "token": "上一步的token",
8

9
  "type": 0
10

11
}

响应内容#

1
{
2

3
    "data": {
4

5
        "uid": "这里的uid并不是真实uid",
6

7
        "code": "返回的code,看着像base64"
8

9
    },
10

11
    "msg": "OK",
12

13
    "status": 0,
14

15
    "type": "A"
16

17
}

获取最终Token#

1
POST https://u8.hypergryph.com/u8/user/auth/v2/token_by_channel_token

请求体#

1
{
2
  "appCode": "4df8f5a7c2ad711b497a",
3
  "channelMasterId": "1",
4
  "channelToken": "{\"code\":\"这里是上一步获取到的code\",\"type\":1,\"isSuc\":true}",
5
  "type": 0,
6
  "platform": 2
7
}

响应内容#

1
{
2

3
    "data": {
4

5
        "token": "这里的一大坨是token",
6

7
        "isNew": false,
8

9
        "uid": "这里的UID并不是游戏uid"
10

11
    },
12

13
    "msg": "OK",
14

15
    "status": 0,
16

17
    "type": ""
18

19
}

获取寻访内容#

WARNING
请求url参数中的token请进行url编码！！！否则会提示token无效

角色池#

1
GET https://ef-webview.hypergryph.com/api/record/char

URL参数#

参数	必填	类型
lang	true	string
pool_type	true	string
token	true	string
server_id	true	int
seq_id	false	int

参数讲解#

lang#

返回的语言，支持：

zh-cn, en-us, ja-jp, ko-kr, zh-tw, es-mx, pt-br, fr-fr, de-de, ru-ru, it-it, id-id, th-th, vi-vn

pool_type#

池子类型，支持：

E_CharacterGachaPoolType_Standard
常驻
E_CharacterGachaPoolType_Special
限定
E_CharacterGachaPoolType_Beginner
新手

token#

最终token，记得一定要url编码！

server_id#

填1即可，不知道值

seq_id#

池子页数，具体请看参数详情

返回体#

1
{
2

3
    "code": 0,
4

5
    "data": {
6

7
        "list": [
8

9
            {
10

11
                "poolId": "special_1_0_3",
12

13
                "poolName": "轻飘飘的信使",
14

15
                "charId": "chr_0022_bounda",
16

17
                "charName": "萤石",
18

19
                "rarity": 4,
20

21
                "isFree": false,
22

23
                "isNew": false,
24

25
                "gachaTs": "1770446953233",
26

27
                "seqId": "311"
28

29
            },
30

31
            {
32

33
                "poolId": "special_1_0_3",
34

35
                "poolName": "轻飘飘的信使",
36

37
                "charId": "chr_0018_dapan",
38

39
                "charName": "大潘",
40

41
                "rarity": 5,
42

43
                "isFree": false,
44

45
                "isNew": false,
46

47
                "gachaTs": "1770446953233",
48

49
                "seqId": "310"
50

51
            },
52

53
            {
54

55
                "poolId": "special_1_0_3",
56

57
                "poolName": "轻飘飘的信使",
58

59
                "charId": "chr_0023_antal",
60

61
                "charName": "安塔尔",
62

63
                "rarity": 4,
64

65
                "isFree": false,
66

67
                "isNew": false,
68

69
                "gachaTs": "1770446953233",
70

71
                "seqId": "309"
72

73
            },
74

75
            {
76

77
                "poolId": "special_1_0_3",
78

79
                "poolName": "轻飘飘的信使",
80

81
                "charId": "chr_0020_meurs",
82

83
                "charName": "卡契尔",
84

85
                "rarity": 4,
86

87
                "isFree": false,
88

89
                "isNew": false,
90

91
                "gachaTs": "1770446953233",
92

93
                "seqId": "308"
94

95
            },
96

97
            {
98

99
                "poolId": "special_1_0_3",
100

101
                "poolName": "轻飘飘的信使",
102

103
                "charId": "chr_0019_karin",
104

105
                "charName": "秋栗",
106

107
                "rarity": 4,
108

109
                "isFree": false,
110

111
                "isNew": false,
112

113
                "gachaTs": "1770446953233",
114

115
                "seqId": "307"
116

117
            }
118

119
        ],
120

121
        "hasMore": true
122

123
    },
124

125
    "msg": ""
126

127
}

参数详情#

poolId：池子ID
charId：角色id
rarity：角色星数
isFree：免费抽数吗？（免费抽数不记录保底）
isNew：新获取的吗
sql_Id：请求id，如果要请求此角色以后的五个角色，就使用此id（一般使用最后一个角色的seqId来获取下一页内容）
hasMore：是否还有更多

武器池#

获取武器池列表#

好像只展示你抽过的

1
GET https://ef-webview.hypergryph.com/api/record/weapon/pool

参数#

lang	看上文的url参数
token	看上文的url参数
server_id	1

返回体#

1
{
2
  "code": 0,
3
  "data": [
4
    {
5
      "poolId": "weponbox_1_0_3",
6
      "poolName": "迅行申领"
7
    },
8
    {
9
      "poolId": "weponbox_1_0_1",
10
      "poolName": "熔铸申领"
11
    },
12
    {
13
      "poolId": "weaponbox_constant_2",
14
      "poolName": "星声申领"
15
    },
16
    {
17
      "poolId": "weaponbox_constant_3",
18
      "poolName": "远途申领"
19
    }
20
  ],
21
  "msg": ""
22
}

获取池子记录#

1
GET https://ef-webview.hypergryph.com/api/record/weapon

参数#

lang	同上文
pool_id	获取到的池子记录中的poolId，如果不填，则是全部
token	同上文
server_id	1
seq_id	同上文

返回体#

1
{
2
  "code": 0,
3
  "data": {
4
    "list": [
5
      {
6
        "poolId": "weponbox_1_0_3",
7
        "poolName": "迅行申领",
8
        "weaponId": "wpn_claym_0003",
9
        "weaponName": "工业零点一",
10
        "weaponType": "E_WeaponType_Claymores",
11
        "rarity": 4,
12
        "isNew": false,
13
        "gachaTs": "1770446778817",
14
        "seqId": "130"
15
      },
16
      {
17
        "poolId": "weponbox_1_0_3",
18
        "poolName": "迅行申领",
19
        "weaponId": "wpn_funnel_0005",
20
        "weaponName": "悼亡诗",
21
        "weaponType": "E_WeaponType_Wand",
22
        "rarity": 5,
23
        "isNew": false,
24
        "gachaTs": "1770446778817",
25
        "seqId": "129"
26
      },
27
      {
28
        "poolId": "weponbox_1_0_3",
29
        "poolName": "迅行申领",
30
        "weaponId": "wpn_sword_0009",
31
        "weaponName": "浪潮",
32
        "weaponType": "E_WeaponType_Sword",
33
        "rarity": 4,
34
        "isNew": false,
35
        "gachaTs": "1770446778817",
36
        "seqId": "128"
37
      },
38
      {
39
        "poolId": "weponbox_1_0_3",
40
        "poolName": "迅行申领",
41
        "weaponId": "wpn_funnel_0001",
42
        "weaponName": "全自动骇新星",
43
        "weaponType": "E_WeaponType_Wand",
44
        "rarity": 4,
45
        "isNew": false,
46
        "gachaTs": "1770446778817",
47
        "seqId": "127"
48
      },
49
      {
50
        "poolId": "weponbox_1_0_3",
51
        "poolName": "迅行申领",
52
        "weaponId": "wpn_lance_0008",
53
        "weaponName": "天使杀手",
54
        "weaponType": "E_WeaponType_Lance",
55
        "rarity": 4,
56
        "isNew": false,
57
        "gachaTs": "1770446778817",
58
        "seqId": "126"
59
      }
60
    ],
61
    "hasMore": true
62
  },
63
  "msg": ""
64
}

返回的参数和上文一样。

后日谈#

这期神了！