{"openapi":"3.1.0","info":{"title":"49 图库源 API","version":"1.1.0","description":"自有图库模板、期开奖与白标图片生成接口。"},"servers":[{"url":"https://tuku.www.codelane.cn"}],"tags":[{"name":"System","description":"服务状态"},{"name":"Gallery","description":"图库读取"},{"name":"Generation","description":"图片生成"},{"name":"Compatibility","description":"旧版图库兼容"}],"paths":{"/api/health":{"get":{"tags":["System"],"summary":"检查服务状态","responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"}}}},"/api/v1/meta":{"get":{"tags":["System"],"summary":"读取当前调用方能力与限流信息","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/v1/catalog":{"get":{"tags":["Gallery"],"summary":"获取最新一期图库","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"lottery_id","in":"query","required":false,"description":"彩种 ID，默认 6","schema":{"type":"integer"}},{"name":"brand_name","in":"query","required":false,"description":"临时品牌名称","schema":{"type":"string"}},{"name":"brand_domain","in":"query","required":false,"description":"临时展示域名","schema":{"type":"string"}}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/v1/issues":{"get":{"tags":["Gallery"],"summary":"获取模板可用期号","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"template_id","in":"query","required":true,"description":"模板 ID","schema":{"type":"integer"}},{"name":"year","in":"query","required":false,"description":"年份","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"返回数量，最多 200","schema":{"type":"integer"}}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/v1/detail":{"get":{"tags":["Gallery"],"summary":"获取指定期号的单图详情","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"template_id","in":"query","required":true,"description":"模板 ID","schema":{"type":"integer"}},{"name":"issue","in":"query","required":true,"description":"完整期号","schema":{"type":"string"}},{"name":"brand_name","in":"query","required":false,"description":"临时品牌名称","schema":{"type":"string"}},{"name":"brand_domain","in":"query","required":false,"description":"临时展示域名","schema":{"type":"string"}}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/v1/generate":{"post":{"tags":["Generation"],"summary":"生成整批图片","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"draw":{"type":"object"},"branding":{"type":"object"}}}}}},"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/index/init":{"get":{"tags":["Compatibility"],"summary":"兼容：读取年份","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/tu/indexedList":{"get":{"tags":["Compatibility"],"summary":"兼容：读取分类","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/tu/loadlist":{"get":{"tags":["Compatibility"],"summary":"兼容：读取最新图库","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/tu/initPicData":{"get":{"tags":["Compatibility"],"summary":"兼容：读取历史期号","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}},"/api/tu/detail":{"get":{"tags":["Compatibility"],"summary":"兼容：读取单图","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"成功，响应体使用 code / message / data 结构"},"401":{"description":"API 密钥无效"},"429":{"description":"超过每分钟调用限制"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerAuth":{"type":"http","scheme":"bearer"}}}}