FinchGramServices
直播目錄

誰會開直播，都在一份開放的清單裡

一份直播來源目錄：會開直播的 Telegram 頻道和創作者、Owncast 和 PeerTube 伺服器，以及廣播機構自己提供的直播串流。它只告訴你去哪裡看，不告訴你現在誰在直播：這要由 app 自己去問每個直播來源。

位址
https://services.finchgram.com/live/v1/
契約（OpenAPI）契約說明
API

四個端點

透過 HTTPS 提供唯讀的 JSON，不需要金鑰，也不用 cookie。回應帶有 ETag，可以快取五分鐘，任何網頁都能讀取。

  • GET/v1/directory這個目錄是什麼：它的名稱、規則在哪裡，以及收錄了多少直播來源
  • GET/v1/categories直播來源所屬的分類，附上各語言的名稱
  • GET/v1/sources所有直播來源，可依種類、分類、語言、國家或關鍵字篩選
  • GET/v1/sources/{id}單一直播來源
目錄收錄

直播來源0

還沒有直播來源

目錄一開始是空的：每個直播來源都要透過 pull request 加進來。

新增第一個
參與貢獻

新增直播來源

一個直播來源就是一個檔案 data/live/sources/<id>.json，透過 pull request 新增。自動檢查會依照契約驗證它；合併之後，目錄從下一次部署起就會提供它。

如何新增直播來源

對每個直播來源的要求

  • 擁有者自己公開的地方：Telegram 使用者名稱、Owncast 伺服器、PeerTube 頻道
  • HLS 串流只能來自播出它的廣播機構，或經其許可
  • 播放時不需要金鑰、登入或其他應用程式的請求標頭
  • 成人內容須明確標示
自建

架設你自己的目錄

把這個儲存庫 fork 過去，用你自己的網域部署到 Cloudflare Workers 上；或者用你喜歡的任何伺服器提供同樣的 JSON。目錄就是一份誰都能維護的清單：能讀一個目錄的 app，就能讀所有目錄。

原始碼