import{_ as o,c as e,a as n,b as s,d as a,e as p,w as d,r,o as c}from"./app-Dgsdh8A6.js";const i={};function D(u,t){const l=r("RouteLink");return c(),e("div",null,[t[16]||(t[16]=n(`

充电列表

获取空间充电公示列表

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

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
自定义充电：
0：无
1：有
vipTypenum大会员类型包月充电时恒为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参数：

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

data中的show_info对象：

字段类型内容备注
showbool是否展示视频充电鸣谢名单
statenum充电功能开启状态-1：未开通充电功能
1：已开通自定义充电
2：已开通包月、自定义充电
3：已开通包月高档、自定义充电
titlestr充电按钮显示文字空字符串或 充电 或 充电中
jump_urlstr跳转url
iconstr充电图标
high_levelobj充电专属视频信息
with_qa_idnum充电问答id

show_info中的high_level对象：

`,35)),s("table",null,[t[15]||(t[15]=s("thead",null,[s("tr",null,[s("th",null,"字段"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"备注")])],-1)),s("tbody",null,[s("tr",null,[t[2]||(t[2]=s("td",null,"privilege_type",-1)),t[3]||(t[3]=s("td",null,"num",-1)),t[4]||(t[4]=s("td",null,"解锁视频所需最低定价档位的代码",-1)),s("td",null,[t[1]||(t[1]=a("见")),p(l,{to:"/docs/electric/monthly.html#%E5%85%85%E7%94%B5%E6%A1%A3%E4%BD%8D%E4%BB%A3%E7%A0%81privilege_type%E4%B8%8E%E5%AE%9A%E4%BB%B7"},{default:d(()=>t[0]||(t[0]=[a("充电档位代码与定价")])),_:1,__:[0]})])]),t[5]||(t[5]=s("tr",null,[s("td",null,"title"),s("td",null,"str"),s("td",null,"提示标题"),s("td",null,[s("code",null,"该视频为「{充电档位名称}」专属视频")])],-1)),t[6]||(t[6]=s("tr",null,[s("td",null,"sub_title"),s("td",null,"str"),s("td",null,"提示子标题"),s("td",null,[s("code",null,"开通「{充电档位定价}元档包月充电」即可观看")])],-1)),t[7]||(t[7]=s("tr",null,[s("td",null,"show_button"),s("td",null,"bool"),s("td",null,"是否显示按钮"),s("td")],-1)),t[8]||(t[8]=s("tr",null,[s("td",null,"button_text"),s("td",null,"str"),s("td",null,"按钮文本"),s("td",null,[s("code",null,"去开通")])],-1)),t[9]||(t[9]=s("tr",null,[s("td",null,"jump_url"),s("td",null,"obj"),s("td",null,"跳转url信息"),s("td",null,"详细信息有待补充")],-1)),t[10]||(t[10]=s("tr",null,[s("td",null,"intro"),s("td",null,"str"),s("td",null,"充电介绍语"),s("td")],-1)),t[11]||(t[11]=s("tr",null,[s("td",null,"open"),s("td",null,"bool"),s("td",null,"（？）"),s("td")],-1)),t[12]||(t[12]=s("tr",null,[s("td",null,"new"),s("td",null,"bool"),s("td",null,"（？）"),s("td")],-1)),t[13]||(t[13]=s("tr",null,[s("td",null,"question_text"),s("td",null,"str"),s("td",null,"（？）"),s("td")],-1)),t[14]||(t[14]=s("tr",null,[s("td",null,"qa_detail_link"),s("td",null,"str"),s("td",null,"（？）"),s("td")],-1))])]),t[17]||(t[17]=n(`

high_level中的jump_url对象：

字段类型内容备注
up_linkstrUP主包月充电购买页面url
paywall_linkstr视频试看后的提示页面url
previewbar_linkstr视频预览页面url

data中的list数组：

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

data中的list数组中的对象：

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

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

字段类型内容备注
vipTypenum大会员类型包月充电时恒为0
自定义充电：
0：无
1：月大会员
2：年度及以上大会员
vipDueMsecnum大会员过期时间恒为0
vipStatusnum大会员状态包月充电时恒为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参数：

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

data对象：

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

page对象：

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

result数组中的对象：

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

config数组中的对象：

字段类型内容备注
midnull总是为null
namenull总是为null
avatarnull总是为null
originalThirdCoinnull总是为null
brokeragenull总是为null
remarknull总是为null
ctimenull总是为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参数：

参数名类型内容必要性备注
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
    }
  }
}
`,53))])}const b=o(i,[["render",D]]),m=JSON.parse('{"path":"/docs/electric/charge_list.html","title":"充电列表","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1746374328000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":2,"url":"https://github.com/SocialSisterYi"},{"name":"wuziqian211","username":"wuziqian211","email":"65224318+wuziqian211@users.noreply.github.com","commits":11,"url":"https://github.com/wuziqian211"},{"name":"z0z0r4","username":"z0z0r4","email":"z0z0r4@outlook.com","commits":1,"url":"https://github.com/z0z0r4"}],"changelog":[{"hash":"591dcf4d9f4b6c4ca8ff3390ae71b4a25df86afa","time":1746374328000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"style: wrap URLs with angle brackets"},{"hash":"35510b7a088cadead2a2e6455de262e6c4c9e657","time":1746207548000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat: add details & replace spaces"},{"hash":"d4f2dad7fd2b0252e4956af062826dacc02225b1","time":1744731994000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"update"},{"hash":"6c1f03e75334aaba6f3b6f3bf346b0326073b779","time":1740498696000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"update"},{"hash":"860fb3dc2aab83f56e4c702bbea9bad80346fb8c","time":1712675777000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Fix #994 (#997)"},{"hash":"f9ee5c3b99335af6bef0d9d902101c565b3bea00","time":1710068023000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"feat: 更新包月充电、获取用户信息、用户关系相关说明 (#981)"},{"hash":"c4a137bde7c554067b24826aa6298749b23b9b53","time":1687154231000,"email":"z0z0r4@outlook.com","author":"z0z0r4","message":"Update charge_list.md (#711)"},{"hash":"d730a5bd5f792e8f297f07a0e64ed2b93d8a83db","time":1678379898000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update charge_list.md"},{"hash":"4140374946a2969c9845086d61dbc4f536612a99","time":1677505003000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update charge_list.md"},{"hash":"490d4c5e1f4559e9fae0feb46e18364317a6112e","time":1677480998000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"新增包月充电功能相关API (#626)"},{"hash":"7a04a16d070d234d8a2909f9f57cd6174b0fbfdb","time":1677432610000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"551965aa0c1ae3bc0604b2ae61c07052b69c7ffd","time":1677408732000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update charge_list.md"},{"hash":"f6760f4be38d5b592d396b211e48c666286524de","time":1677124138000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🔨remove header index"},{"hash":"7d89ece2ac46425810647c4ac92acf5f3721cb68","time":1676998806000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🚀调整项目结构"}]},"filePathRelative":"docs/electric/charge_list.md"}');export{b as comp,m as data};