Skip to content

Latest commit

 

History

History
531 lines (439 loc) · 17.3 KB

charge_list.md

File metadata and controls

531 lines (439 loc) · 17.3 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 …… ……
29 obj 充电用户30 最后一项

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:无
1:有
vipType num 大会员类型 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参数:

参数名 类型 内容 必要性 备注
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 作用尚不明确
list array 本月充电用户列表

data中的show_info对象:

字段 类型 内容 备注
show bool 是否展示视频充电鸣谢名单 false:不展示
true:展示
state num 0

data中的list数组:

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

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:无
1:月会员
2:年会员
vipDueMsec num 0 作用尚不明确
vipStatus num 大会员状态 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参数:

参数名 类型 内容 必要性 备注
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
success bool
data obj 信息本体

data对象:

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

page对象:

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

config数组中的对象:

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

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

示例:

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