企业级 幸运飞艇历史开奖API

认证与授权 (Authentication)

所有的API请求都需要进行身份验证。我们使用基于Token的认证机制。您需要在我们平台注册账号并生成一个唯一的 API Key。在每次发起HTTP请求时，必须将此Key包含在请求头（Headers）或URL参数中。

请求头方式 (推荐)

Authorization: Bearer YOUR_API_KEY_HERE

URL参数方式

GET https://api.https://zh-luckyfeiting-site.com/v1/latest?token=YOUR_API_KEY_HERE

频率限制 (Rate Limits)

为了保证所有用户的访问体验及服务器的稳定性，我们对API的调用频率进行了严格的限制。具体的限制额度取决于您所购买的套餐等级。当您超过限制时，API将返回 429 Too Many Requests 状态码。

我们在每次请求的响应头中包含了当前的限流状态信息，方便开发者进行流量控制：

• X-RateLimit-Limit: 当前时间窗口内允许的最大请求次数。
• X-RateLimit-Remaining: 当前时间窗口内剩余的请求次数。
• X-RateLimit-Reset: 限流窗口重置的Unix时间戳。

错误代码说明 (Error Codes)

当请求失败时，接口会返回标准的HTTP状态码，并在响应体中提供详细的JSON格式错误信息。标准的错误响应结构如下：

{
  "success": false,
  "error_code": 401,
  "message": "Invalid API Key provided."
}

获取指定彩种（幸运飞艇或极速飞艇）的最新一期开奖结果。该接口数据缓存时间极短，适合用于前端页面的实时开奖倒计时与结果展示。

路径参数 (Path Parameters)

• game_code (必填, string): 彩种代码。支持的值：xyft (幸运飞艇), jsft (极速飞艇)。

响应示例 (Response)

{
  "success": true,
  "data": {
    "game_code": "xyft",
    "game_name": "幸运飞艇",
    "issue": "20231025088",
    "open_numbers": "08,02,10,04,01,05,09,03,07,06",
    "open_time": "2023-10-25 21:04:00",
    "next_issue": "20231025089",
    "next_open_time": "2023-10-25 21:09:00",
    "status": "opened"
  },
  "timestamp": 1698239045
}

注：open_numbers 为逗号分隔的10位数字字符串，代表冠军至第十名的开奖号码。

根据条件查询历史开奖记录，支持分页。适用于构建历史数据大厅、走势图表等功能。

查询参数 (Query Parameters)

响应示例 (Response)

{
  "success": true,
  "data": {
    "items": [
      {
        "issue": "20231025088",
        "open_numbers": "08,02,10,04,01,05,09,03,07,06",
        "open_time": "2023-10-25 21:04:00"
      },
      // ... 更多记录
    ],
    "pagination": {
      "total": 50000,
      "per_page": 20,
      "current_page": 1,
      "total_pages": 2500
    }
  }
}