开发者平台

用户动态相关接口-游戏/进程/音乐

本文档主要列出用户动态相关接口。

本文档中的接口均符合接口规范,如有疑问,建议先查阅接口引言

接口 接口说明 维护状态
/api/v3/game 游戏列表 正常
/api/v3/game/create 添加游戏 正常
/api/v3/game/update 更新游戏 正常
/api/v3/game/delete 删除游戏 正常
/api/v3/game/activity 添加游戏/音乐记录(开始玩/听) 正常
/api/v3/game/delete-activity 删除游戏/音乐记录(结束玩/听) 正常

游戏列表

接口说明

地址 请求方式 说明
/api/v3/game GET

参数列表

参数名 类型 是否必填 说明
type string 类型:0全部 1用户创建 2系统创建

返回参数说明

object-game

参数名 类型 说明
id int 主键 id
name string 名称(游戏/状态名称)
type int 类型 0 游戏 1VUP 2 进程
options string 进程额外信息
kmhook_admin bool 是否以管理员权限启动 KOOK
process_name array 进程名称
product_name array 产品名称
icon string 游戏图标

返回示例

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "items": [
            {
                "id": 111111,
                "name": "CS",
                "type": 0,
                "options": "",
                "kmhook_admin": false,
                "process_name": [
                    "cstrike"
                ],
                "product_name": [],
                "icon": "https://img.chuanyuapp.com/assets/2022-01/12fe639ebc762e0e5347d197b9686c0c.ico/icon"
            },
        ],
        "meta": {
            "page": 2,
            "page_total": 2,
            "page_size": 50,
            "total": 100
        },
        "sort": {}
    }
}

添加游戏

接口说明

地址 请求方式 说明
/api/v3/game/create POST 请注意, 本接口有数据插入频率限制,单日最大可创建 5 个游戏数据!!

参数列表

参数名 类型 是否必填 说明
name string 名称
icon string 图标

返回参数说明

<object-game>

返回示例

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "id": 111111,
        "name": "KOOK",
        "type": 0,
        "options": "",
        "kmhook_admin": false,
        "process_name": [],
        "product_name": [],
        "icon": ""
    }
}

更新游戏

接口说明

地址 请求方式 说明
/api/v3/game/update POST

参数列表

参数名 类型 是否必填 说明
id int 名称
name string 名称
icon string 图标

返回参数说明

<object-game>

返回示例

{
    "code": 0,
    "message": "操作成功",
    "data": {
        "id": 111111,
        "name": "KOOK",
        "type": 0,
        "options": "",
        "kmhook_admin": false,
        "icon": "https://xxx.com/xxxxxxxxx...",
        "process_name": [],
        "product_name": []
    }
}

删除游戏

接口说明

地址 请求方式 说明
/api/v3/game/delete POST

参数列表

参数名 类型 是否必填 说明
id int 主键 id

返回参数说明

返回示例

{
    "code": 0,
    "message": "操作成功",
    "data": {}
}

添加游戏/音乐记录-开始玩/听

接口说明

地址 请求方式 说明
/api/v3/game/activity POST

参数列表

参数名 类型 必传 参数区域 说明
id int POST 游戏 id
data_type int POST 请求数据类型 1游戏 2音乐
software string POST 软件名,枚举值:['cloudmusic'、'qqmusic'、'kugou'],默认为'cloudmusic'
singer string POST 歌手名,data_type=2 时必传
music_name string POST 歌曲名,data_type=2 时必传

返回参数说明

传参示例

游戏动态

{"id":111111,"data_type":1}

音乐动态

{"software":"kugou","singer":"许嵩","music_name":"山水之间","data_type":2}

返回示例

{
    "code": 0,
    "message": "操作成功",
    "data": {}
}

删除游戏/音乐记录-结束玩/听

接口说明

地址 请求方式 说明
/api/v3/game/delete-activity POST

参数列表

返回参数说明

参数名 类型 必传 参数区域 说明
data_type int POST 请求数据类型 1游戏 2音乐

传参示例

{"data_type": 1}

返回示例

{
    "code": 0,
    "message": "操作成功",
    "data": {}
}