接口门户

鉴权与格式

在请求头中使用 X-Api-Key 或 Authorization: Bearer KEY。每个账号可创建5个有效Key，密钥仅在创建时完整展示一次。

每个 API Key 每 5 秒最多访问一次，所有开放接口及 JSON/XML 共用额度。超限返回 HTTP 429，请按 Retry-After 响应头的秒数等待后重试；被限速的请求不会延长等待时间。

默认与 .json 返回JSON；.xml返回XML。错误统一返回JSON及相应HTTP状态码。时间使用北京时间，期号为字符串；未开奖的预测命中为null。

接口一览

路径	用途	参数
`/api/kj`	最近开奖与倒计时	nbr=1..100
`/api/qh`	指定期号开奖	nbr=期号（必填）
`/api/keno`	真实Keno原号	nbr=1..100
`/api/pc28`	PC28 开奖与计算过程（由 Keno 原号计算）	nbr=1..100 或 issue=期号；detail=1 含计算过程
`/api/pc5`	PC5 开奖：万千百十个、牛牛、形态	nbr=1..100 或 issue=期号；detail=1 含计算过程
`/api/pc10`	PC10 开奖：冠军至第10名、冠亚和、龙虎	nbr=1..100 或 issue=期号；detail=1 含计算过程
`/api/yk`	开奖统计	date 或 from/to，最多31天
`/api/yl`	本地遗漏	无
`/api/cl`	本地长龙	无
`/api/ds`	单双算法实绩	nbr=1..100
`/api/dx`	大小算法实绩	nbr=1..100
`/api/sz`	双组算法实绩	nbr=1..100
`/api/sha`	杀组算法实绩	nbr=1..100
`/api/dt`	本站公开算法大厅	category/q/page/pageSize/sort
`/api/sf`	算法详情与实绩	id=本站算法编号（必填）

参数与数据范围

大厅分类：big_small、odd_even、combo_predict、kill_group、double_group。分页默认20条，最多50条。排序支持rate20_desc/asc、rate100_desc/asc、streak_desc、miss_desc、max_streak_desc、max_miss_desc、created_desc、favorites_desc。

预测接口从本站已审核、未锁定的公开算法中选择实绩较高的算法。没有真实预测时返回空数组；不会把回测伪装成真实预测。原站私有算法公式不会通过本站接口公开。

遗漏使用最近10000期本地真实样本，sample标明实际条数；未在样本中出现的项目missing为null。hx28已停用，其余game值使用加拿大28。

请求示例

curl 'https://pc28.fm/api/kj.json?nbr=5' \
  -H 'X-Api-Key: YOUR_PC28_KEY'

{"countdown":"02:30","data":[
  {"nbr":"期号","time":"YYYY-MM-DD HH:MM:SS",
   "number":"4+8+2=14","combination":"大双"}
]}

PC5 / PC10

与 PC28 同期，由同一期 20 个 Keno 原号按本站公开的规则计算，只返回已有原号的期。number 按万、千、百、十、个位或冠军到第 10 名的顺序排列。

GET /api/pc5.json?nbr=1
{"countdown":"02:30","data":[
  {"nbr":"期号","time":"YYYY-MM-DD HH:MM:SS","number":"1,9,1,3,8",
   "sum":22,"niu":"牛2","hand":"一对","size":"小","parity":"双"}
]}

GET /api/pc10.json?issue=期号
{"countdown":"02:30","data":[
  {"nbr":"期号","time":"YYYY-MM-DD HH:MM:SS","number":"1,3,9,8,7,4,2,10,6,5",
   "gyh":4,"size":"小","parity":"双","dragon":"虎"}
]}

PC5：sum 五位之和，niu 牛牛（牛1–牛9、牛牛、无牛），hand 形态（豹子、四条、葫芦、三条、二对、一对、顺子、单牌），size 万位大小（5–9 大），parity 个位单双。PC10：gyh 冠亚和，size 冠亚和大小（12 及以上大），parity 冠亚和单双，dragon 冠军对第 10 名的龙虎。计算过程可在首页「计算过程」中逐期查看。

计算过程（detail=1）

在 /api/pc28、/api/pc5、/api/pc10 上加 detail=1，每期多返回一个 detail，可以自行核对或展示计算过程；不加时返回内容不变。位置都从 1 开始计。

keno：本期 20 个原号，从小到大。unused_positions：不参与计算的位置（第 1、20 位）。
groups（PC28、PC5）：每一组的 name（第一球 / 万位…）、positions 位置、values 号码、sum 之和、digit 取个位。
niu（PC5）：凑成 10 的倍数的三位 three 及其和 three_sum，余下两位 rest 及其和 rest_sum（取个位即牛几）；无牛时为 null。
PC10：champion 冠军（PC28 第一球与车号），start 排序起点（PC28 第三球与车号），cars 其余 9 车的车道顺序，lanes 每条车道的 car、up/down 上数和下数及其位置、decimals 小数（最多 10 位）、score 取值（末 5 位）、up_plus_down、rank 名次；second_pk 取值相同的车按 up_plus_down 从大到小的先后。

GET /api/pc10.json?issue=期号&detail=1
{"data":[{"nbr":"期号","number":"10,4,1,3,9,6,5,2,7,8", …,
  "detail":{"keno":[3,4,5,…,78],"champion":{"pc28_first_ball":0,"car":10},
   "start":{"pc28_third_ball":5,"car":5},"cars":[5,6,7,8,9,1,2,3,4],
   "lanes":[{"car":5,"up":4,"down":47,"decimals":"0851063829","score":"63829","rank":7}, …],
   "second_pk":[{"score":"66666","cars":[{"car":3,"up_plus_down":110},{"car":9,"up_plus_down":88},{"car":6,"up_plus_down":53}]}]}}]}

在线测试

测试结果将在此显示