BAC Document

充电列表

获取空间充电公示列表

https://api.bilibili.com/x/ugcpay-rank/elec/month/up

请求方式：GET

本接口需要在请求标头中提供有效的浏览器 UA，如 Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36

url参数：

参数名类型内容必要性备注
up_midnum目标用户mid必要

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-400：请求错误
88214：up主未开通充电
messagestr错误信息
ttlnum0
dataobj数据本体

data对象：

字段类型内容备注
countnum本月充电人数
listarray本月充电用户列表
total_countnum总计充电次数
totalnum总计充电次数同total_count
special_daynum0作用尚不明确

data中的list数组：

项类型内容备注
0obj充电用户1
nobj充电用户(n+1)按照充电排名排列
……obj…………
29obj充电用户30最后一项

data中的list数组中的对象：

字段类型内容备注
unamestr充电用户昵称
avatarstr充电用户头像url
midnum充电对象mid
pay_midnum充电用户mid
ranknum充电用户排名取决于充电的多少
trend_typenum0作用尚不明确
vip_infoobj充电用户会员信息
messagestr充电留言无为空
msg_hiddennum0作用尚不明确

list数组中的对象中的vip_info对象：

字段类型内容备注
vipDueMsecnum大会员过期时间（？）恒为0
vipStatusnum大会员状态0：无
1：有
vipTypenum大会员类型0：无
1：月会员
2：年会员及以上

示例：

查询用户mid=53456的充电公示列表

curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
-A 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36' \
--data-urlencode 'up_mid=53456'
查看响应示例：
{
    "code": 0,
    "message": "",
    "ttl": 0,
    "data": {
        "count": 397,
        "list": [
            {
                "uname": "Mars韩笑",
                "avatar": "https://i1.hdslb.com/bfs/face/a46599fa41cac672eda677e334f0be93cca02f1f.jpg",
                "mid": 53456,
                "pay_mid": 5683462,
                "rank": 1,
                "trend_type": 0,
                "vip_info": {
                    "vipDueMsec": 0,
                    "vipStatus": 1,
                    "vipType": 2
                },
                "message": "你真棒，你是奇迹！（Warma真的是太棒了！",
                "message_hidden": 0
            },
            {
                "uname": "愚星-",
                "avatar": "https://i1.hdslb.com/bfs/face/7e4a8b150567a20a1b075aa3894dd3674a1e6ebe.jpg",
                "mid": 53456,
                "pay_mid": 382630072,
                "rank": 2,
                "trend_type": 0,
                "vip_info": {
                    "vipDueMsec": 0,
                    "vipStatus": 1,
                    "vipType": 1
                },
                "message": "感谢您给我带来的快乐！我的人生遇见你是我的荣幸！！",
                "message_hidden": 0
            },
            {
                "uname": "なか酱",
                "avatar": "https://i0.hdslb.com/bfs/face/d4b74091d7f1c336399625dc062ddc93d676bcdc.jpg",
                "mid": 53456,
                "pay_mid": 446080731,
                "rank": 3,
                "trend_type": 0,
                "vip_info": {
                    "vipDueMsec": 0,
                    "vipStatus": 1,
                    "vipType": 2
                },
                "message": "",
                "message_hidden": 0
            }
        ],
        "total_count": 27291,
        "total": 27291,
        "special_day": 0
    }
}

获取视频充电鸣谢名单

https://api.bilibili.com/x/web-interface/elec/show

请求方式:GET

url参数：

参数名类型内容必要性备注
midnum目标用户mid必要
aidnum目标稿件avid必要（可选）avid与bvid任选一个
bvidstr目标稿件bvid必要（可选）avid与bvid任选一个

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-400：请求错误
-404：无视频
62001：不需要展示充电信息
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象：

字段类型内容备注
show_infoobj展示选项
av_countnum目标视频充电人数
countnum本月充电人数
total_countnum总计充电人数
special_daynum0作用尚不明确
display_numnum0作用尚不明确
listarray本月充电用户列表

data中的show_info对象：

字段类型内容备注
showbool是否展示视频充电鸣谢名单false：不展示
true：展示
statenum0

data中的list数组：

项类型内容备注
0obj充电用户1
nobj充电用户(n+1)按照充电排名排列
……obj…………
29obj充电用户30最后一项

data中的list数组中的对象：

字段类型内容备注
midnum充电对象mid
pay_midnum充电用户mid
ranknum充电用户排名取决于充电的多少
unamestr充电用户昵称
avatarstr充电用户头像url
messagestr充电留言无为空
msg_deletednum0作用尚不明确
vip_infoobj充电用户会员信息
trend_typenum0作用尚不明确

data中的list数组中的vip_info对象：

字段类型内容备注
vipTypenum大会员类型0：无
1：月会员
2：年会员
vipDueMsecnum0作用尚不明确
vipStatusnum大会员状态0：无
1：有

示例：

获取视频av967773538/BV1up4y1y77i，用户mid=53456的视频充电鸣谢名单

avid方式：

curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
--data-urlencode 'mid=53456' \
--data-urlencode 'aid=967773538'

bvid方式：

curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
--data-urlencode 'mid=53456' \
--data-urlencode 'bvid=BV1up4y1y77i'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "show_info": {
      "show": true,
      "state": 0
    },
    "av_count": 0,
    "count": 0,
    "total_count": 19422,
    "special_day": 0,
    "display_num": 0,
    "list": [
      {
        "mid": 53456,
        "pay_mid": 1216085164,
        "rank": 1,
        "uname": "JZ72",
        "avatar": "http://i1.hdslb.com/bfs/face/3d741682fafc286999b5e8089a844ae4f46651fe.jpg",
        "message": "Warma YYDS ",
        "msg_deleted": 0,
        "vip_info": {
          "vipType": 2,
          "vipDueMsec": 0,
          "vipStatus": 1
        },
        "trend_type": 0
      },
      {
        "mid": 53456,
        "pay_mid": 305858373,
        "rank": 2,
        "uname": "适应性神经系统",
        "avatar": "http://i0.hdslb.com/bfs/face/2ad38dec879f66c32b5e5cb1750cb3f3e446bf91.jpg",
        "message": "",
        "msg_deleted": 0,
        "vip_info": {
          "vipType": 1,
          "vipDueMsec": 0,
          "vipStatus": 0
        },
        "trend_type": 0
      },
      ......
    ]
  }
}

查询我收到的充电列表

https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord

请求方式：GET

认证方式：Cookie（SESSDATA）

url参数：

参数名类型内容必要性备注
currentPagenum页数必要
pageSizenum分页大小必要取值范围[1,50]
customerIdnum(?)必要目前为固定值：10026
beginTimestr开始日期非必要yyyy-MM-dd
endTimestr结束日期非必要yyyy-MM-dd

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
800501007：user not login
800501008：内部错误
800501011：请求参数有误
errnonum
msgstr
showMsgstr
successbool
dataobj信息本体

data对象：

字段类型内容备注
pageobj分页信息
resultarray充电信息本体
configarray(?)

page对象：

字段类型内容备注
currentPagenum当前页数
pageSizenum当前分页大小
totalCountnum记录总数
totalPagenum总页数

config数组中的对象：

字段类型内容备注
midnull总是为null
namenull总是为null
avatarnull总是为null
originalThirdCoinnull总是为null
brokeragenull总是为null
remarknull总是为null
ctimenull总是为null

result数组中的对象：

字段类型内容备注
midnum充电人mid
namestr充电人昵称
avatarstr充电人头像
originalThirdCoinnum原始B币数
brokeragenum实际收到的贝壳数
remarkstr充电渠道Web/安卓/iOS
ctimestr充电时间yyyy-MM-dd HH:mm:ss

示例：

curl -G 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord' \
--data-urlencode 'currentPage=1' \
--data-urlencode 'pageSize=2' \
--data-urlencode 'customerId=10026' \
-b 'SESSDATA=xxx'
查看响应示例：
{
  "code": 0,
  "errno": 0,
  "msg": "SUCCESS",
  "showMsg": "交易成功",
  "data": {
    "page": {
      "currentPage": 1,
      "pageSize": 2,
      "totalCount": 311,
      "totalPage": 156
    },
    "result": [
      {
        "mid": 2233,
        "name": "2233",
        "avatar": "http://i2.hdslb.com/bfs/face/f42b7f47c80648d2ee1231f2435b527c60302289.jpg",
        "originalThirdCoin": 2,
        "brokerage": 1.34,
        "remark": "Web",
        "ctime": "2022-04-12 17:34:47"
      },
      {
        "mid": 2233,
        "name": "2233",
        "avatar": "http://i0.hdslb.com/bfs/face/member/noface.jpg",
        "originalThirdCoin": 2,
        "brokerage": 0.68,
        "remark": "iOS",
        "ctime": "2022-04-10 03:41:10"
      }
    ],
    "config": [
      {
        "mid": null,
        "name": null,
        "avatar": null,
        "originalThirdCoin": null,
        "brokerage": null,
        "remark": null,
        "ctime": null
      }
    ]
  },
  "success": true
}

查询历史充电数据

https://member.bilibili.com/x/h5/elec/rank/recent

请求方式：GET

认证方式：Cookie（SESSDATA）

url参数：

参数名类型内容必要性备注
pnnum页数非必要
psnum分页大小非必要取值范围[1,20]

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
messagestr错误信息
ttlnum1
dataobj信息本体

data对象：

字段类型内容备注
listarray充电信息本体
pagerobj分页信息

list数组中的对象：

字段类型内容备注
aidnum0
bvidstr空
elec_numnum充电电池数
titlestr空
unamestr空
avatarstr空
ctimestr充电时间yyyy-MM-dd HH:mm:ss

pager对象：

字段类型内容备注
currentnum当前页数
sizenum当前分页大小
totalnum记录总数

示例：

curl -G 'https://member.bilibili.com/x/h5/elec/rank/recent' \
-b 'SESSDATA=xxx'
查看响应示例：
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "list": [
            {
                "aid": 0,
                "bvid": "",
                "elec_num": 50,
                "title": "",
                "uname": "",
                "avatar": "",
                "ctime": "2020-04-02 03:12:22"
            },
            {
                "aid": 0,
                "bvid": "",
                "elec_num": 20,
                "title": "",
                "uname": "",
                "avatar": "",
                "ctime": "2020-04-02 03:12:00"
            }
        ],
        "pager": {
            "current": 1,
            "size": 20,
            "total": 38
        }
    }
}