模板: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}}