模板:BilibiliUP/doc

本模板用以获取指定B站UP数据。

服务器端配置

配置项		Bilibili相关		Niconico相关	Youtube相关
		视频接口	UP接口	视频接口	视频接口	频道接口
缓存时长
缓存更新 最大频率控制	低频时段
	低频时段频率
	高频时段频率
代理节点个数

注：

• 缓存更新最大频率是指连续60秒内服务器或代理节点进行缓存刷新的最大次数，超出最大次数之后的请求将会延长缓存有效期至解除频率控制时间点，并会在每日的低频时段被服务器重试，直至完成缓存刷新。
• 建议通过搭配onlyTime参数来向读者提示缓存时间，如有需要强制刷新请联系AnnAngela[更多]讨论页贡献上传历史封禁及历史被删贡献移动日志巡查日志用户权限及日志用户查核。

参数说明

• id：必填，填写UP的用户ID（可通过UP的个人空间https://space.bilibili.com/xxxxx获得，纯数字）
• type：必填，填写需要获取的信息类型：
  • name：UP昵称；
  • face_url：UP头像；
  • follower：粉丝数；
  • following：关注数；
  • video_count：UP视频投稿数；（暂无文章投稿数）
• color：选填，改变字体颜色
• format：选填，处理除注册时间以外的数字类型值时指定输出的数据的格式，只能填以下三种参数：
  • round / toFixed（默认值）：
    • 数据小于10000时显示原始数据；
    • 大于10000时以“万”为单位显示：
      • 此时四舍五入保留的小数位数以{{{decimalLength|}}}指定，只接受正整数，默认为1；
  • plain：直接显示原始数据
  • separate：显示带千位分隔符的数据
• onlyTime：选填，值不为空时只显示数据获取时间点（此时可不填参数type）
• dateFormat：选填，处理获取数据的时间点时直接传递给moment库，所以请使用moment库可用的格式，默认值为LLL（2020年1月2日晚上4点50分）
• imgStyle：选填，处理头像时的样式，格式为【参数名1】:【参数值1】,【参数名2】:【参数值2】：
  • height：指定头像高度，单位为px，默认值为auto；
  • width：指定头像宽度，单位为px，默认值为——当height未指定时是150，height指定时为auto；
  • link：不为空时指定头像可点击，点击后跳转对应UP的BB空间。

输出

• 在无法获得数据（例如设置的信息类型错误）的时候会显示相关错误信息；
• 否则以原数值显示。

举例

参数举例	结果举例	用法举例
name	--	{{BilibiliUP|id=1300259363|type=name}}
face_url	--	{{BilibiliUP|id=1300259363|type=face_url|imgStyle=link:true}}
follower	--	{{BilibiliUP|id=1300259363|type=follower}}
following	--	{{BilibiliUP|id=1300259363|type=following}}
video_count	--	{{BilibiliUP|id=1300259363|type=video_count}}
color	--	{{BilibiliUP|id=1300259363|type=following|color=red}}
round / toFixed	--	{{BilibiliUP|id=1300259363|type=follower|format=toFixed}}
plain	--	{{BilibiliUP|id=1300259363|type=follower|format=plain}}
separate	--	{{BilibiliUP|id=1300259363|type=follower|format=separate}}
decimalLength	--	{{BilibiliUP|id=1300259363|type=follower|format=toFixed|decimalLength=4}}
onlyTime	--	{{BilibiliUP|id=1300259363|onlyTime=1}}
dateFormat	--	{{BilibiliUP|id=1300259363|onlyTime=1|dateFormat=L}}