🔌接口文档

1. 基础信息

• Base URL: https://www.qiuxiaozhiai.cn/wp-json/abv2/v1
• 默认响应格式: JSON

2. 鉴权与限流

接口受到严格的访问控制，必须提供 API Key 才能调用，API Key 请联系管理员获取。

鉴权方式

推荐使用 HTTP Header 传递 API Key。

Header 方式 (推荐):

X-ABV2-API-KEY: your_api_key_here

URL 参数方式:

?api_key=your_api_key_here

限流规则

• 默认限制: 每个 IP 每分钟 5 次请求。
• 超限响应: HTTP 429 Too Many Requests。

3. 接口列表

3.1 球队搜索

支持通过中文、英文名称或别名模糊搜索球队。

示例请求:

curl -H "X-ABV2-API-KEY: xxx" "https://www.qiuxiaozhiai.cn/wp-json/abv2/v1/team-info?q=切尔西"

成功响应 (200 Example):

                                                                                                                                                                                                                                                                        {
                                                                                                                                                                                                                                                                          "success": true,
                                                                                                                                                                                                                                                                          "data": [
                                                                                                                                                                                                                                                                            {
                                                                                                                                                                                                                                                                              "team_id": 123,
                                                                                                                                                                                                                                                                              "name": "Chelsea",
                                                                                                                                                                                                                                                                              "country": "England",
                                                                                                                                                                                                                                                                              "aliases": ["切尔西", "车子"]
                                                                                                                                                                                                                                                                            }
                                                                                                                                                                                                                                                                          ]
                                                                                                                                                                                                                                                                        }
                                                                                                                                                                                                                                                                                

3.2 球队 Logo 获取

获取指定球队的 Logo URL。优先精确匹配，支持模糊匹配。

示例请求:

curl -H "X-ABV2-API-KEY: xxx" "https://www.qiuxiaozhiai.cn/wp-json/abv2/v1/team-logo?name=利物浦"

成功响应 (200 Example):

                                                                                                                                                                                                                                                                        {
                                                                                                                                                                                                                                                                          "success": true,
                                                                                                                                                                                                                                                                          "data": {
                                                                                                                                                                                                                                                                            "team_id": 456,
                                                                                                                                                                                                                                                                            "name": "Liverpool",
                                                                                                                                                                                                                                                                            "logo_url": "https://www.baidu.com/football/teams/40.png"
                                                                                                                                                                                                                                                                          }
                                                                                                                                                                                                                                                                        }
                                                                                                                                                                                                                                                                                

3.3 赛前实时数据

获取指定比赛的赛前实时数据 (JSON 格式)。

示例请求:

curl -H "X-ABV2-API-KEY: xxx" "https://www.qiuxiaozhiai.cn/wp-json/abv2/v1/prematch-data/20251216-周二001"

成功响应 (200 Example):

                                                                                                                                                                                                                                                                        {
                                                                                                                                                                                                                                                                          "home_team": "Team A",
                                                                                                                                                                                                                                                                          "away_team": "Team B",
                                                                                                                                                                                                                                                                          "analysis": {
                                                                                                                                                                                                                                                                              "recent_form": "...",
                                                                                                                                                                                                                                                                              "head_to_head": "..."
                                                                                                                                                                                                                                                                          },
                                                                                                                                                                                                                                                                          "prediction": "..."
                                                                                                                                                                                                                                                                        }
                                                                                                                                                                                                                                                                                

3.4 赛前分析报告

获取指定比赛的赛前分析报告。

示例请求:

curl -H "X-ABV2-API-KEY: xxx" "https://www.qiuxiaozhiai.cn/wp-json/abv2/v1/analysis-report/20251216-周二001"

成功响应 (200 Example):

                                                                                                                                                                                                                                                                        {
                                                                                                                                                                                                                                                                          "id": 1024,
                                                                                                                                                                                                                                                                          "title": "周二001 分析报告：加的夫城 vs 切尔西",
                                                                                                                                                                                                                                                                          "content": "<p>文章正文内容...</p>",
                                                                                                                                                                                                                                                                          "date": "2025-12-16 10:00:00",
                                                                                                                                                                                                                                                                          "link": "https://www.qiuxiaozhiai.cn/archives/1024"
                                                                                                                                                                                                                                                                        }
                                                                                                                                                                                                                                                                                

4. 错误码

• 400 Bad Request: 缺少必要参数。
• 401 Unauthorized: 未提供 API Key。
• 403 Forbidden: API Key 无效或已停用。
• 404 Not Found: 未找到对应的数据 (球队或比赛)。
• 429 Too Many Requests: 请求过于频繁 (超过每分钟 5 次)。