API

srcdslist 每款遊戲的社群伺服器即時資料(JSON 格式),每 5 分鐘更新。

從 teamwork.tf 過來的嗎?

路徑與欄位和 teamwork.tf 的 API v1 相同。把 teamwork.tf 換成 srcdslist.com,你的工具應該就能繼續運作。你的舊金鑰在這裡無效;不帶金鑰的請求也能用(請見限制),或在你的帳號頁面建立金鑰。

遊戲

每個端點預設回應 TF2,除非你加上 ?game=l4d2 或 ?game=cs2(例如 /api/v1/stats?game=cs2)。伺服器清單、新聞與地圖頁面也遵循同樣規則。 其他遊戲:?game=gmod(Garry's Mod)、?game=l4d(Left 4 Dead)與 ?game=css(Counter-Strike: Source)。

限制與金鑰

端點

路徑回傳
/api/v1/quickplay遊戲模式,分為 gamemodes_official 與 gamemodes_community,各有 id、title、desc、color、playing。
/api/v1/quickplay/{gamemode}單一遊戲模式及其 playing。
/api/v1/quickplay/{gamemode}/servers該模式中的伺服器(陣列)。
/api/v1/quickplay/server?ip=IP&port=PORT一台伺服器;如果省略 port,則是該 IP 上的所有伺服器。一律是陣列。
/api/v1/community/provider/{slug}一個社群:名稱、描述、網站、規則、Steam 群組、Discord、主要地區。
/api/v1/community/provider/{slug}/stats它的玩家數、各地區玩家數、遊戲模式、在線與全部伺服器數。
/api/v1/community/provider/{slug}/servers它在線的伺服器(陣列)。可選篩選條件:gamemode(模式的代稱,或 _unknown)、region(例如 Europe)、hide_full=1、hide_password=1、hide_empty=1。
/api/v1/map-stats/search?search_term=TEXT最多 50 個包含該文字的地圖名稱。
/api/v1/map-stats/map/{map}首次與最後一次出現時間、同時最多玩家與伺服器數、平均玩家數、是否官方、相關版本、遊戲模式。
/api/v1/customserverlist玩家建立的伺服器清單:名稱、描述、建立者、訂閱數、篩選條件(filter_hostname_whitelist、filter_hostname_blacklist 與 teamwork.tf 相同,另加遊戲模式、地區、地圖前綴、標籤)。
/api/v1/customserverlist/{id} 與 /{id}/servers一個清單,以及目前在其中的伺服器。
/api/v1/competitive/provider/{provider} 與 /stats大廳網站或聯賽;對於我們能辨認的大廳網站,會顯示目前玩家數,以及使用中或空著的伺服器。
/api/v1/news (?source=)這款遊戲的新聞標題:標題、連結、來源、發布時間。
/api/v1/stats總計:玩家數、有玩家的伺服器、各地區與各模式玩家數、被排除的偽造與掛機玩家、Steam 自己對這款遊戲的統計。

伺服器欄位

ip、port(字串)、name、reachable、provider(社群代稱或 null)、valve_secure、map_name、map_name_next、players、max_players、gamemodes、gametype(伺服器的標籤)、has_password、has_rtd、has_randomcrits、has_norespawntime、has_alltalk。srcdslist 另外加上:humans、bots、region、trust、steam_relay、official(由 Valve 營運:L4D2 的官方伺服器)。

與 teamwork.tf 的差異