49 图库源 · 开发者文档

十分钟接入
自己的图库图片

一套接口完成图库读取、历史期号查询、品牌定制和整批出图。

BASE URLhttps://tuku.www.codelane.cn/api

当前版本: 1.1.0
速率限制: 240 次 / 分钟
数据编码: UTF-8 JSON

开始

最快的一次请求

从后台复制调用方密钥，然后读取最新一期的全部图库。

cURL

curl "https://tuku.www.codelane.cn/api/v1/catalog?lottery_id=6" \
  -H "X-API-Key: tk_your_api_key"

鉴权

身份验证

除健康检查和 OpenAPI 规范外，所有接口都需要调用方密钥。

X-API-Key 请求头

X-API-Key: tk_your_api_key

兼容

Bearer 请求头

Authorization: Bearer tk_your_api_key

密钥只应放在服务端

不要把正式密钥写进公开网页、App 安装包或仓库。为不同网站创建独立调用方，便于单独停用和追踪。

约定

统一响应格式

成功和失败都返回 JSON；先判断 HTTP 状态，再判断 code。

成功

{
  "code": 1,
  "message": "ok",
  "data": { ... }
}

失败

{
  "code": 0,
  "message": "API 密钥无效。",
  "data": null
}

GET/api/v1/catalog最新一期图库

读取某个彩种最新一期的全部启用模板。返回的 image_url 是已经写入当前调用方品牌的成品原图。

参数	类型	必填	说明
`lottery_id`	integer	否	彩种 ID，默认 6
`brand_name`	string	否	临时品牌名称，需调用方开启覆盖权限
`brand_domain`	string	否	临时展示域名

JavaScript（服务端）

const response = await fetch(
  'https://tuku.www.codelane.cn/api/v1/catalog?lottery_id=6',
  { headers: { 'X-API-Key': process.env.TUKU_API_KEY } }
);
const result = await response.json();
const images = result.data.items;

GET/api/v1/issues历史期号

获取某个模板可查询的开奖期号。可按年份筛选，默认返回最近 50 期。

参数	类型	必填	说明
`template_id`	integer	是	从 catalog 返回的模板 ID
`year`	integer	否	例如 2026
`limit`	integer	否	1–200，默认 50

cURL

curl "https://tuku.www.codelane.cn/api/v1/issues?template_id=1&year=2026" \
  -H "Authorization: Bearer tk_your_api_key"

GET/api/v1/detail单图详情

指定模板和期号获取单张成品。如果尚未生成，接口会即时生成并缓存；相同参数以后直接返回同一地址。

参数	类型	必填	说明
`template_id`	integer	是	图库模板 ID
`issue`	string	是	7 位完整期号，例如 2026251
`brand_name`	string	否	本次图片使用的品牌
`brand_domain`	string	否	本次图片使用的域名

PHP

$query = http_build_query([
    'template_id' => 1,
    'issue' => '2026251',
]);
$context = stream_context_create(['http' => ['header' =>
    "X-API-Key: {$apiKey}\r\n"
]]);
$result = json_decode(file_get_contents(
    'https://tuku.www.codelane.cn/api/v1/detail?' . $query,
    false,
    $context
), true);

POST/api/v1/generate整批生成

使用已保存期号生成全部模板；拥有“提交期开奖”权限的调用方也可以在请求中先保存新期开奖。

请求体 · 已有期开奖

{
  "draw": {
    "lottery_id": 6,
    "issue": "2026251"
  },
  "branding": {
    "brand_name": "新香港六合彩",
    "brand_domain": "example.com"
  }
}

提交新期开奖需要哪些字段？

draw 至少包含以下内容：

issue_full：7 位完整期号
numbers：正好 7 个号码，可用数组或逗号分隔字符串
lottery_id：默认 6
lottery_name、draw_date、weekday、previous_numbers、zodiac：可选

该能力默认关闭，应只给可信的数据同步服务开启。

白标

按调用方或单次请求定制品牌

后台可为每个调用方设置默认品牌。开启覆盖权限后，请求还能临时更换以下字段。

字段	示例	约束
`brand_name`	新香港六合彩	最多 100 字符
`brand_domain`	example.com	只保留合法域名
`brand_position`	top_left	上/下 × 左/中/右
`brand_color`	#111111	HEX 颜色
`domain_color`	#111111	HEX 颜色
`brand_font_size`	18	10–96

品牌写进原图

品牌文字与域名由服务端直接写入 JPG 成品，不是网页上的浮层，下载、转发和 API 调用都会保留。

兼容

旧版图库接口映射

现有前台无需一次重写，可按原来的调用顺序逐步迁移。

接口	用途	主要参数
`/api/index/init`	读取年份	—
`/api/tu/indexedList`	读取分类	`lotteryType`
`/api/tu/loadlist`	读取最新列表	`lotteryType`、`year`
`/api/tu/initPicData`	读取历史期号	`picId`、`year`
`/api/tu/detail`	读取单图	`picId`、`qi`

错误

状态码与处理建议

失败时不会返回成品地址，调用方应记录 message 并按状态码处理。

400参数不合法

修正请求内容后再试。

401密钥无效

检查请求头或后台启用状态。

403权限不足

调用方未开启开奖提交权限。

404资源不存在

检查模板 ID、期号和接口路径。

429请求过快

等待下一分钟并加入退避重试。

500生成失败

保留 message，联系源站管理员。

调试

在线连通测试

密钥只发送到当前域名的 catalog 接口，不会保存到浏览器。

响应结果

{
  "提示": "填写密钥后点击发送测试请求"
}