Skland_API

森空岛API接口合集以及文档示例

明日方舟工具箱 / 罗德岛移动终端 开发组

说明

该文档中的API接口均基于鹰角网络森空岛APP中的游戏数据页面。

根据APP内显示数据 本文档可能包含的 API 以及json数据路径

更多实现以及可能请关注 API数据解读 部分

在没有特殊说明的情况下，下面的情况保持默认
状态码：

• 0： 请求成功
• 其他值： 各种错误情况，可以在响应消息中查看详细描述

响应说明:

• 如果请求失败，状态码会反映错误的类型，并在响应消息中提供详细描述。

API快查

---鹰角网络凭证获取---
-手机密码登录-
/POST https://as.hypergryph.com/user/auth/v1/token_by_phone_password
{"phone": "手机号","password": "密码"}
返回 {"status":0,"type":"A","msg":"OK","data":{"token":"xxx"}}

-验证码登录-
发送验证码
/POST https://as.hypergryph.com/general/v1/send_phone_code
{"phone":"199********","type":2}
返回 {"status":0,"type":"A","msg":"OK"}

验证验证码
/POST https://as.hypergryph.com/user/auth/v2/token_by_phone_code
{"phone":"199********","code":"******"}
返回 {"status":0,"type":"A","msg":"OK","data":{"token":"FQyXK4vy**********GkI7Rr"}}

---森空岛凭证获取---
请先获取鹰角网络凭证

获取OAuth2授权代码
/POST https://as.hypergryph.com/user/oauth2/v2/grant
{"token":"鹰角网络凭证","appCode":"4ca99fa6b56cc2ba","type":0}
返回 {"status":0,"type":"A","msg":"OK","data":{"code":"****","uid":"12**********1"}}

获取Cred凭证
/POST https://zonai.skland.com/api/v1/user/auth/generate_cred_by_code
{"kind":1,"code":"****"}
返回 {"code":0,"message":"OK","data":{"cred":"32位凭证","userId":"8****3"}}

---森空岛凭证校验(存活/有效性)---
/POST https://zonai.skland.com/api/v1/user/auth/generate_cred_by_code
header['cred'] = 32位cred
返回 {"code":0,"message":"OK","data":{"policyList":[],"isNewUser":false}}

---森空岛APP---
获取玩家绑定角色列表
/GET https://zonai.skland.com/api/v1/game/player/binding
header = {"cred": ""}
返回 {"code":0,"message":"OK","data":{"list":[{"appCode":"arknights","appName":"明日方舟","bindingList":[{"uid":"68463675","isOfficial":true,"isDefault":true,"channelMasterId":"1","channelName":"官服","nickName":"探姬#9315","isDelete":false}],"defaultUid":""}]}}

---游戏内数据---
 /GET https://zonai.skland.com/api/v1/game/player/info?uid=?
 header['cred'] = 32位cred
 返回 {"code":0,"message":"OK","data":{很大很大的数据}}

获取鹰角账号凭证(登录)

注意 鹰角网络通行证账号登录凭证 是用于 鹰角网络账号系统校验您登录的唯一凭证，

是鹰角网络所有API交互的身份标识基础。

泄露登录凭证属于极度危险操作，为了您的账号安全，请勿将此凭证以任何形式告知他人！

使用账号密码登录

API名称： 通过手机号和密码获取凭证

API请求URL： https://as.hypergryph.com/user/auth/v1/token_by_phone_password

请求方法： /POST

请求参数： JSON格式(application/json)

请求示例：

{
  "phone": "手机号",
  "password": "密码"
}

响应： JSON格式

响应示例：

{
    "status": 0,
    "type": "A",
    "msg": "OK",
    "data": {
        "token": "xxx"
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含用户令牌的JSON数据。

使用手机验证码登录

发送手机验证码

此 API 允许用户请求发送验证码到指定手机号，用于后续的验证码登录流程。

请求URL： https://as.hypergryph.com/general/v1/send_phone_code

请求方法： POST

请求参数： JSON格式(application/json)

请求示例：

{
  "phone": "199********",
  "type": 2
}

响应:

{
    "status": 0,
    "type": "A",
    "msg": "OK"
}

获取验证码登录令牌

用户在输入收到的验证码后，使用此 API 获取与手机号相关联的令牌，以完成登录流程。

请求URL： https://as.hypergryph.com/user/auth/v2/token_by_phone_code

请求方法： POST

请求参数： JSON格式(application/json)

请求示例：

{
  "phone": "199********",
  "code": "******"
}

响应： JSON格式

响应示例：

{
    "status": 0,
    "type": "A",
    "msg": "OK",
    "data": {
        "token": "FQyXK4vy**********GkI7Rr"
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含用户令牌的JSON数据。

鹰角账号凭证校验

请求URL： https://as.hypergryph.com/user/info/v1/basic?token=鹰角账号凭证

请求方法： GET

请求参数：

请求示例：

无请求体，仅包含查询参数 token

响应： JSON格式

响应示例：

{
    "status": 0,
    "type": "A",
    "msg": "OK",
    "data": {
        "hgId": "1*********6",// 鹰角账号id 注意，该部分会完全显示
        "phone": "199****9999",// 手机号 注意，打码部分不会显示
        "email": null, // 绑定邮箱
        "identityNum": "1111**********1111", // 身份证信息 注意，中间打码部分不会显示
        "identityName": "探**",// 姓名信息 注意，只会显示姓氏
        "isMinor": false, // 是否未成年
        "isLatestUserAgreement": true // 用户是否已同意了最新的用户协议
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含用户基本信息的JSON数据。

获取森空岛凭证

森空岛的API使用cred作为身份凭证，当然该凭证基于鹰角网络通行证账号登录凭证生成。

获取 OAuth2 授权代码

此 API 允许用户使用令牌进行 OAuth2 授权操作。

请求URL： https://as.hypergryph.com/user/oauth2/v2/grant

请求方法： POST

请求参数： JSON格式(application/json)

请求示例：

{
  "token": "FQyXK4vy**********GkI7Rr",
  "appCode": "4ca99fa6b56cc2ba",
  "type": 0
}

响应： JSON格式

响应示例：

{
    "status": 0,
    "type": "A",
    "msg": "OK",
    "data": {
        "code": "mmKkGqm******************************************************************UjnSamjI9ow==",
        "uid": "12**********1"
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含授权代码和用户ID的JSON数据。

获取Cred

此 API 将使用上一步的OAuth2 授权代码获取Cred。

请求URL： https://zonai.skland.com/api/v1/user/auth/generate_cred_by_code

请求方法： POST

请求参数： JSON格式

请求示例：

{
  "kind": 1,
  "code": "mmKkGqm******************************************************************UjnSamjI9ow=="
}

响应： JSON格式

响应示例：

{
    "code": 0,
    "message": "OK",
    "data": {
        "cred": "********************************",
        "userId": "8****3"
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含Cred和用户ID的JSON数据。

Cred校验

此 API 可以校验Cred的有效性，可用于过期提醒和其他操作。

请求URL： https://zonai.skland.com/api/v1/user/check

请求方法： GET

请求头：

请求示例：

无请求体，仅包含请求头

响应： JSON格式

响应示例：

{
    "code": 0,
    "message": "OK",
    "data": {
        "policyList": [],
        "isNewUser": false
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含策略列表和新用户状态的JSON数据。

功能性接口

获取账号信息

（其实就是把Cookie中的ACCOUNT取出来显示罢了，对普通用户的辅助API吧xd）

请求URL： https://web-api.skland.com/account/info/hg

请求方法： GET

请求头：

请求示例：

无请求体，仅包含请求头

响应： JSON格式

响应示例：

{
    "code": 0,
    "data": {
        "content": "JZ*********+Zk2sXaas"
    },
    "msg": "接口会返回您的鹰角网络通行证账号的登录凭证，此凭证可以用于鹰角网络账号系统校验您登录的有效性。泄露登录凭证属于极度危险操作，为了您的账号安全，请勿将此凭证以任何形式告知他人！"
}

森空岛APP

获取玩家绑定角色列表

请求URL： https://zonai.skland.com/api/v1/game/player/binding

请求方法： GET

请求头：

请求示例：

无请求体，仅包含请求头

响应： JSON格式

响应示例：

{
    "code": 0,
    "message": "OK",
    "data": {
        "list": [
            {
                "appCode": "arknights",
                "appName": "明日方舟",
                "bindingList": [
                    {
                        "uid": "68463675",
                        "isOfficial": true,
                        "isDefault": true,
                        "channelMasterId": "1",
                        "channelName": "官服",
                        "nickName": "探姬#9315",
                        "isDelete": false
                    }
                ],
                "defaultUid": ""
            }
        ]
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含游戏玩家绑定信息的JSON数据。

签到

此 API 允许用户进行游戏签到操作，获取签到奖励。

请求URL： https://zonai.skland.com/api/v1/game/attendance

请求方法： POST

请求头：

请求体： JSON格式

请求示例：

{
    "uid": "uid",
    "gameId": "channelMasterId"
}

响应： JSON格式

响应数据示例：

{
    "code": 0,
    "message": "OK",
    "data": {
        "ts": "1693823939",
        "awards": [
            {
                "resource": {
                    "id": "4003",
                    "type": "DIAMOND_SHD",
                    "name": "合成玉",
                    "rarity": 4
                },
                "count": 500,
                "type": "first"
            },
            {
                "resource": {
                    "id": "2002",
                    "type": "CARD_EXP",
                    "name": "初级作战记录",
                    "rarity": 2
                },
                "count": 3,
                "type": "daily"
            }
        ]
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含签到奖励信息的JSON数据。

游戏内数据

获取玩家数据

此 API 允许用户通过Cred和用户ID（uid）获取其在游戏内的相关数据，emm 直接dump了1w行（（（

请求URL： https://zonai.skland.com/api/v1/game/player/info

请求方法： GET

请求头：

请求参数：

请求示例：

Copy code
无请求体，仅包含查询参数 uid

**响应：**JSON格式

响应数据示例：

{
    "code": 0,
    "message": "OK",
    "data": {
        // huge data
    }
}

响应说明:

• 当请求成功时，会返回状态码0，以及一个包含游戏内玩家数据的JSON数据。

(由于篇幅原因 放在dump.json 中 有需要的博士可以自行查看（悲)

API数据解读

部分数据解读，欢迎pr更新，以便完成自动化更多的可能性:p