YouTube Track API

端點

POST https://track.nekolive.net/youtube/send/Your UUID

Headers

Content-Type

application/x-www-form-urlencoded

參數

title

標題、曲名

artist

藝人、團隊名稱

album

專輯圖片網址

progress 選填

目前播放進度，單位為秒（整數）。需與 duration 一起提供，顯示頁才會出現時間軸。

duration 選填

影片總長度，單位為秒（整數，需大於 0）。直播等無法取得長度的內容請直接省略。

paused 選填

是否暫停播放，1 為暫停、0 為播放中，省略時視為播放中。暫停時顯示頁的時間軸會停止推進。

範例

curl --request POST \
    --url https://track.nekolive.net/youtube/send/Your UUID \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data 'title=Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)' \
    --data 'artist=Rick Astley' \
    --data 'album=https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg' \
    --data 'progress=42' \
    --data 'duration=213' \
    --data 'paused=0'

201

伺服器成功接收到資料並發送至客戶端

400

標題為必填項目

403

來源只能是 youtube.com 或 music.youtube.com，有額外請求請聯繫我們

404

找不到使用者

500

伺服器錯誤，請聯繫我們協助處理