bricks
快速上手
1.1 需求分析

需求声明

网站: 酷狗直播热门游戏主播列表 (opens in a new tab)

需求:获取主播的 ID、昵称、房间号、直播状态、评分、开始直播的时间等信息

接口分析

接口地址: https://fx1.service.kugou.com/mfanxing-home/h5/cdn/room/index/list_v2?page=1&cid=6000

接口参数:

  • cid 为固定的参数
  • page 代表当前页数,因此我们请求时需要变化的仅有:page 参数

响应示例:

{
  "code": 0,
  "data": {
    "hasNextPage": 1,
    "list": [
      {
        "borderIcon": "",
        "downloadGuide": "下载音音直播,看高清直播",
        "downloadGuideType": 0,
        "fxSingerIcon": "",
        "imgPath": "http://p3.fx.kgimg.com/v2/fxroomcover/9472003bf727401c357d68ee0a98d560.jpg",
        "isExclusive": 1,
        "kugouId": 1204981270,
        "leftTopIcon": "",
        "leftbuttomIcon": "",
        "liveType": 6,
        "newStarTagsIcon": [
          {
            "tagsColor": "",
            "tagsId": 0,
            "tagsName": ""
          }
        ],
        "newStarTagsList": [],
        "nickName": "冷小芯1",
        "recomJson": "{\"page_id\":\"30009\",\"useRec\":\"1\",\"uiMode\":\"0\",\"pageIndex\":\"1\",\"useRecCfg\":\"0\",\"dtime\":\"1672904800914\",\"recom_id\":\"1672904800914\",\"pageSize\":\"80\",\"recall_id\":\"22\",\"test_groupid\":\"100\",\"starKugouId\":\"1204981270\"}",
        "recommendReason": "",
        "repreSong": "",
        "rightTopIcon": "",
        "rightbuttomIcon": "",
        "roomId": 4626181,
        "score": {
          "value": "0.0n",
          "type": "Big Number"
        },
        "signType": 3,
        "starIcon": "http://s3.fx.kgimg.com/fxstatic/images/starLevel/pc/24.png",
        "starLevel": 24,
        "startTime": "2时31分前",
        "status": 1,
        "userId": 1204981270,
        "verifyInfo": {
          "kugou_v_status": 1,
          "singerExt": {
            "duration": "911",
            "hot": "0",
            "level": "0",
            "nextHot": "1000"
          },
          "tme_v_status": 0
        },
        "viewerNum": 156
      }
    ]
  },
  "msg": "",
  "times": 1672904800925
}

响应分析:

  • code0 时表示接口请求成功
  • data.hasNextPage 表示是否存在下一页
  • 接口结果存在于data.list 内,每一项为一个字典, 代表一份数据
    • kugouId:酷狗 ID
    • userId: 用户 ID;
    • nickName:昵称;
    • roomId:房间号;
    • status:直播状态;
    • score:评分;
    • startTime:开始的开播时间