Skip to content

Latest commit

 

History

History
531 lines (437 loc) · 18.1 KB

charge_list.md

File metadata and controls

531 lines (437 loc) · 18.1 KB

充电列表

获取空间充电公示列表

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_mid num 目标用户mid 必要

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
-400:请求错误
88214:up主未开通充电
message str 错误信息
ttl num 0
data obj 数据本体

data对象:

字段 类型 内容 备注
count num 本月充电人数
list array 本月充电用户列表
total_count num 总计充电次数
total num 总计充电次数 total_count
special_day num 0 作用尚不明确

data中的list数组:

类型 内容 备注
0 obj 充电用户1
n obj 充电用户(n+1) 按照充电排名排列
…… obj …… ……

data中的list数组中的对象:

字段 类型 内容 备注
uname str 充电用户昵称
avatar str 充电用户头像url
mid num 充电对象mid
pay_mid num 充电用户mid
rank num 充电用户排名 取决于充电的多少
trend_type num 0 作用尚不明确
vip_info obj 充电用户会员信息
message str 充电留言 无为空
msg_hidden num 0 作用尚不明确

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

字段 类型 内容 备注
vipDueMsec num 大会员过期时间 恒为0
vipStatus num 大会员状态 包月充电时恒为0
自定义充电:
0:无
1:有
vipType num 大会员类型 包月充电时恒为0
自定义充电:
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": 8521,
        "list": [
            {
                "uname": "云梦澡堂",
                "avatar": "https://i1.hdslb.com/bfs/face/6589df5fdac0f80593f6a86e4d88dc08e25df3d2.jpg",
                "mid": 53456,
                "pay_mid": 1555775947,
                "rank": 1,
                "trend_type": 0,
                "vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 },
                "message": "",
                "message_hidden": 0
            },
            {
                "uname": "在下小天子",
                "avatar": "https://i1.hdslb.com/bfs/face/a3bfbe6186889bb50dcd87c1156d07a70227a25b.jpg",
                "mid": 53456,
                "pay_mid": 508630801,
                "rank": 2,
                "trend_type": 0,
                "vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 },
                "message": "",
                "message_hidden": 0
            }
        ],
        "total_count": 41919,
        "total": 41919,
        "special_day": 0
    }
}

获取视频充电鸣谢名单

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

请求方式:GET

url参数:

参数名 类型 内容 必要性 备注
mid num 目标用户mid 必要
aid num 目标稿件avid 必要(可选) avid与bvid任选一个
bvid str 目标稿件bvid 必要(可选) avid与bvid任选一个

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
-400:请求错误
-404:无视频
62001:不需要展示充电信息
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象:

字段 类型 内容 备注
show_info obj 展示选项
av_count num 目标视频充电人数
count num 本月充电人数
total_count num 总计充电人数
special_day num 0 作用尚不明确
display_num num 0 作用尚不明确
cnt_priv_type num 0 作用尚不明确
list array 本月充电用户列表

data中的show_info对象:

字段 类型 内容 备注
show bool 是否展示视频充电鸣谢名单
state num 充电功能开启状态 -1:未开通充电功能
1:已开通自定义充电
2:已开通包月、自定义充电
3:已开通高档、自定义充电
title str 充电按钮显示文字 空字符串或 充电充电中
jump_url str 跳转url
icon str 充电图标
high_level obj 高档充电信息

show_info中的high_level对象:

字段 类型 内容 备注
privilege_type num
title str
sub_title str
show_button bool
button_text str
jump_url obj
intro str
open bool
new bool

data中的list数组:

类型 内容 备注
0 obj 充电用户1
n obj 充电用户(n+1) 按照充电排名排列
…… obj …… ……

data中的list数组中的对象:

字段 类型 内容 备注
mid num 充电对象mid
pay_mid num 充电用户mid
rank num 充电用户排名 取决于充电的多少
uname str 充电用户昵称
avatar str 充电用户头像url
message str 充电留言 无为空
msg_deleted num 0 作用尚不明确
vip_info obj 充电用户会员信息
trend_type num 0 作用尚不明确

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

字段 类型 内容 备注
vipType num 大会员类型 包月充电时恒为0
自定义充电:
0:无
1:月大会员
2:年度及以上大会员
vipDueMsec num 大会员过期时间 恒为0
vipStatus num 大会员状态 包月充电时恒为0
自定义充电:
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": 2,
      "title": "充电",
      "jump_url": "https://www.bilibili.com/h5/upower/index?mid=53456&navhide=1&prePage=video&oid=967773538",
      "icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png",
      "high_level": {
        "privilege_type": 0,
        "title": "",
        "sub_title": "",
        "show_button": false,
        "button_text": "",
        "jump_url": { "up_link": "", "paywall_link": "", "previewbar_link": "" },
        "intro": "",
        "open": false,
        "new": false
      }
    },
    "av_count": 0,
    "count": 0,
    "total_count": 41919,
    "special_day": 0,
    "display_num": 0,
    "cnt_priv_type": 0,
    "list": [
      {
        "mid": 53456,
        "pay_mid": 1555775947,
        "rank": 1,
        "uname": "云梦澡堂",
        "avatar": "https://i1.hdslb.com/bfs/face/6589df5fdac0f80593f6a86e4d88dc08e25df3d2.jpg",
        "message": "",
        "msg_deleted": 0,
        "vip_info": { "vipType": 0, "vipDueMsec": 0, "vipStatus": 0 },
        "trend_type": 0
      },
      {
        "mid": 53456,
        "pay_mid": 508630801,
        "rank": 2,
        "uname": "在下小天子",
        "avatar": "https://i1.hdslb.com/bfs/face/a3bfbe6186889bb50dcd87c1156d07a70227a25b.jpg",
        "message": "",
        "msg_deleted": 0,
        "vip_info": { "vipType": 0, "vipDueMsec": 0, "vipStatus": 0 },
        "trend_type": 0
      }
    ]
  }
}

查询我收到的充电列表

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

请求方式:GET

认证方式:Cookie(SESSDATA)

url参数:

参数名 类型 内容 必要性 备注
currentPage num 页数 必要
pageSize num 分页大小 必要 取值范围[1,50]
customerId num (?) 必要 目前为固定值:10026
beginTime str 开始日期 非必要 yyyy-MM-dd
endTime str 结束日期 非必要 yyyy-MM-dd

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
800501007:user not login
800501008:内部错误
800501011:请求参数有误
errno num
msg str
showMsg str
data obj 信息本体
success bool

data对象:

字段 类型 内容 备注
page obj 分页信息
result array 充电信息本体
config array (?)

page对象:

字段 类型 内容 备注
currentPage num 当前页数
pageSize num 当前分页大小
totalCount num 记录总数
totalPage num 总页数

result数组中的对象:

字段 类型 内容 备注
mid num 充电人mid
name str 充电人昵称
avatar str 充电人头像
originalThirdCoin num 原始B币数
brokerage num 实际收到的贝壳数
remark str 充电渠道 Web/安卓/iOS
ctime str 充电时间 yyyy-MM-dd HH:mm:ss

config数组中的对象:

字段 类型 内容 备注
mid null 总是为null
name null 总是为null
avatar null 总是为null
originalThirdCoin null 总是为null
brokerage null 总是为null
remark null 总是为null
ctime null 总是为null

示例:

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参数:

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

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
message str 错误信息
ttl num 1
data obj 信息本体

data对象:

字段 类型 内容 备注
list array 充电信息本体
pager obj 分页信息

list数组中的对象:

字段 类型 内容 备注
aid num 0
bvid str
elec_num num 充电电池数
title str
uname str
avatar str
ctime str 充电时间 yyyy-MM-dd HH:mm:ss

pager对象:

字段 类型 内容 备注
current num 当前页数
size num 当前分页大小
total num 记录总数

示例:

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
        }
    }
}