API文档 - NBA 数据中心

GET /api/summary 获取数据概要

描述： 获取NBA数据库的整体概要信息

参数

无参数

请求示例

curl http://api.tailtag.net/api/summary

响应示例

{
                                "status": "success",
                                "summary": {
                                "total_teams": 30,
                                "total_players": 5103,
                                "active_players": 530,
                                "cache_info": {
                                "cache_size": 0,
                                "cache_timeout": 300,
                                "use_cache": true
                                }
                                }
                                }

GET /api/teams 获取所有球队

描述： 获取NBA所有30支球队的详细信息

参数

无参数

请求示例

curl http://api.tailtag.net/api/teams

GET /api/players 获取球员列表

描述： 获取NBA球员列表

参数

参数名	类型	说明
active_only	boolean	可选是否只返回活跃球员 (true/false)

请求示例

curl "http://api.tailtag.net/api/players?active_only=true"

WebSocket 实时连接

我们提供基于 Socket.IO 的实时数据推送服务，无需客户端轮询。

连接信息

Endpoint: http://api.tailtag.net
Protocol: Polling + WebSocket
Event: game_update

客户端示例 (JavaScript)

const socket = io('http://api.tailtag.net');

                                socket.on('connect', () => {
                                console.log('Connected to NBA Stream');
                                });

                                socket.on('game_update', (msg) => {
                                // msg.data 包含最新的比赛列表
                                console.log('Received update:', msg.data);
                                });

GET /api/search/player 搜索球员

描述： 根据姓名搜索球员

参数

参数名	类型	说明
q	string	必需搜索关键词（球员姓名）

请求示例

curl "http://api.tailtag.net/api/search/player?q=LeBron"

GET /api/standings 联盟排名

描述： 获取NBA东西部联盟排名

参数

参数名	类型	说明
season	string	可选赛季 (默认: 2023-24)

请求示例

curl "http://api.tailtag.net/api/standings?season=2023-24"

GET /api/top-scorers 得分榜

描述： 获取NBA得分排行榜

参数

参数名	类型	说明
season	string	可选赛季 (默认: 2023-24)
limit	integer	可选返回数量 (默认: 10)

请求示例

curl "http://api.tailtag.net/api/top-scorers?limit=5"

GET /api/team/{id} 球队详情

描述： 获取指定球队的详细信息，包括阵容和统计

参数

参数名	类型	说明
id	integer	必需球队ID

请求示例

curl http://api.tailtag.net/api/team/1610612747

GET /api/scoreboard 比赛记分板

描述： 获取指定日期的NBA比赛信息

参数

参数名	类型	说明
date	string	可选比赛日期 (YYYY-MM-DD格式，默认为今天)

请求示例

curl "http://api.tailtag.net/api/scoreboard?date=2024-01-15"

GET /api/game/{id}/preview 比赛前瞻

描述： 获取比赛前的分析数据、交锋记录和球队领袖

参数

参数名	类型	说明
id	string	必需比赛ID
home_id	int	必需主队ID
visitor_id	int	必需客队ID

GET /api/game/{id}/play-by-play 逐回合直播

描述： 获取比赛的实时逐回合文字直播数据

参数

参数名	类型	说明
id	string	必需比赛ID

NBA API 文档

基础URL

数据格式

参数

请求示例

响应示例

参数

请求示例

参数

请求示例

WebSocket 实时连接

连接信息

客户端示例 (JavaScript)

参数

请求示例

参数

请求示例

参数

请求示例

参数

请求示例

参数

请求示例

参数

参数

响应格式说明

成功响应

错误响应