开发者API 赋能您的应用

我们提供稳定、高效的彩票数据API，助您轻松构建各类彩票相关应用，实现您的创意。

核心特性

实时开奖数据

提供毫秒级更新的彩票开奖结果，确保您的应用数据始终保持最新。

海量历史数据

覆盖各类彩票多年的历史开奖数据，支持按期号、日期等多种维度查询。

走势分析接口

提供号码分布、冷热趋势、遗漏统计等分析接口，助力您构建智能预测系统。

安全与稳定

采用高可用性架构和严格的安全措施，保障您的数据传输和应用稳定运行。

专业技术支持

我们的技术团队随时为您提供专业的API集成指导和问题解答。

多语言SDK

提供多种编程语言的SDK和示例代码，降低您的开发门槛。

接口清单

获取历史开奖

获取指定彩种在特定日期范围内的历史开奖数据。

请求信息

POST /api/services/lottery/history

请求参数 (Body)

参数名	类型	必填	描述
lotteryId	string	是	彩种ID，如 `SSQ` (双色球), `DLT` (大乐透)
startDate	string	是	开始时间，格式 YYYY-MM-DD HH:mm:ss
endDate	string	是	结束时间，格式 YYYY-MM-DD HH:mm:ss

请求头 (Headers)

参数名	类型	必填	描述
Client_api_key	string	是	您的API密钥

响应示例

{
  "success": true,
  "code": 200,
  "message": "获取历史开奖数据成功",
  "data": [
    {
      "lotteryId": "SSQ",
      "period": "20240101",
      "drawDate": "2024-01-01",
      "numbers": ["01", "05", "12", "18", "25", "30"],
      "specialNumbers": ["08"]
    },
    {
      "lotteryId": "SSQ",
      "period": "20240102",
      "drawDate": "2024-01-02",
      "numbers": ["03", "09", "16", "22", "28", "33"],
      "specialNumbers": ["12"]
    }
  ]
}

代码示例

// JavaScript 示例
const response = await fetch('https://api.example.com/api/services/lottery/history', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Client_api_key': '*********'
  },
  body: JSON.stringify({
    lotteryId: 'JNDEB',
    startDate: '2024-01-01 00:00:00', // 示例时间，实际使用时请根据需求调整
    endDate: '2024-01-31 23:59:00'   // 示例时间，实际使用时请根据需求调整
  })
});

// Java 示例
String requestBody = "{\"lotteryId\":\"JNDEB\",\"startDate\":\"2024-01-01 00:00:00\",\"endDate\":\"2024-01-31 23:59:00\"}"; // 示例时间，实际使用时请根据需求调整
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.example.com/api/services/lottery/history"))
    .header("Content-Type", "application/json")
    .header("Client_api_key", "*********")
    .POST(HttpRequest.BodyPublishers.ofString(requestBody))
    .build();

// PHP 示例
$requestBody = json_encode(array(
    'lotteryId' => 'JNDEB',
    'startDate' => '2024-01-01 00:00:00', // 示例时间，实际使用时请根据需求调整
    'endDate' => '2024-01-31 23:59:00'   // 示例时间，实际使用时请根据需求调整
));
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Client_api_key: *********'
));

公用常量

彩种Code对照表

常用彩种的Code对照表，在API调用时使用对应的Code作为lotteryId参数。

彩种名称	Code	说明
加拿大2.8	JNDEB	加拿大2.8彩票
香港六合彩	XGLHC	香港六合彩
七星彩	QXC	七星彩
加拿大时时彩	JNDSSC	加拿大时时彩
加拿大六合彩	JNDLHC	加拿大六合彩
币安比特币三分彩	BTCTHREE	币安比特币三分彩
币安比特币五分彩	BTCFIVE	币安比特币五分彩
排列三	PLS	排列三
澳门六合彩	AMLHC	澳门六合彩
台湾六合彩	TWLHC	台湾六合彩
快乐8	KL8LHC	快乐8
重庆时时彩	CQSSC	重庆时时彩
大乐透	DLT	大乐透
福彩3D	FCSD	福彩3D
北京PK10	BJPK10	北京PK10

使用说明

在调用API时，请使用上表中的Code作为lotteryId参数的值。注意：所有Code必须使用大写字母。例如：获取双色球数据时，lotteryId应设置为"SSQ"。

多语言调用示例

JavaScript (Fetch API)

使用现代 JavaScript 的 Fetch API 获取数据。

async function getLatestLotteryResultJs() {
  try {
    // 实际应用中，这里会是您的API端点
    const response = await fetch('https://api.example.com/api/services/lottery/latest', {
      method: 'POST',
      headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json',
        'Client_api_key': '*********'  // 替换为您的实际API密钥
      },
      body: JSON.stringify({
        lotteryId: 'SSQ'
      })
    }); 
    const data = await response.json();
    console.log(data);
    return data;
  } catch (error) {
    console.error('Error fetching lottery data:', error);
    return { success: false, message: error.message };
  }
}

// 调用示例
// getLatestLotteryResultJs().then(result => console.log(result));

立即开始您的开发之旅

注册账户，获取API密钥，即可开始调用我们的彩票数据服务。