API 文档

所有公开接口都需要在请求头中提供 X-API-Key。

接入示例

curl

curl -H "X-API-Key: ldp_xxxxx" \
  http://localhost:3000/api/v1/lotteries/MO_MARK_SIX_WATCH/latest

JavaScript fetch

const res = await fetch("http://localhost:3000/api/v1/lotteries/MO_MARK_SIX_WATCH/latest", {
  headers: { "X-API-Key": "ldp_xxxxx" }
});
const json = await res.json();

PHP curl

$ch = curl_init("http://localhost:3000/api/v1/lotteries/MO_MARK_SIX_WATCH/latest");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: ldp_xxxxx"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

接口列表

GET	/api/v1/me	当前 API Key 信息，不返回原文或 hash
GET	/api/v1/lotteries	彩种列表
GET	/api/v1/lotteries/:code/latest	指定彩种最新开奖
GET	/api/v1/lotteries/:code/history?limit=50	指定彩种历史开奖
GET	/api/v1/lotteries/:code/result?issue=xxx	按期号查询开奖
GET	/api/v1/status	数据源状态

返回示例

{
  "success": true,
  "data": {
    "lotteryCode": "MO_MARK_SIX_WATCH",
    "lotteryName": "澳门六合彩",
    "officialStatus": "WATCH_ONLY",
    "issue": "2026159",
    "openCode": [
      "12",
      "04",
      "28",
      "17",
      "20",
      "46"
    ],
    "specialCode": "39",
    "openTime": "2026-06-08T21:32:32.000Z",
    "sourceStatus": "UNVERIFIED",
    "fetchedAt": "2026-06-09T00:10:30.000Z",
    "updatedAt": "2026-06-09T00:10:30.000Z",
    "disclaimer": "本站仅提供开奖结果查询、开奖历史、开奖倒计时、数据源监控及 API 数据服务，不提供购买彩票、下注、充值、提现、派奖、输赢评判或任何资金结算服务。开奖结果以官方或数据源公布为准。"
  }
}

错误码说明

401	UNAUTHORIZED	未提供 X-API-Key、API Key 错误或客户已禁用
403	FORBIDDEN_LOTTERY	API Key 不允许访问该彩种
404	NOT_FOUND	彩种或开奖结果不存在
429	RATE_LIMITED	超过每分钟或每日请求限制
500	SERVER_ERROR	服务端异常

服务边界

本站仅提供开奖结果查询、开奖历史、开奖倒计时、数据源监控及 API 数据服务，不提供购买彩票、下注、充值、提现、派奖、输赢评判或任何资金结算服务。开奖结果以官方或数据源公布为准。