开放接口 · 终末地养成手册

一、接口一览

接口	说明
`GET /api/v1/meta`	元信息：版本、收录数量、来源优先级、使用条款
`GET /api/v1/operators`	干员列表，支持 `element`(冰/火/电磁/物理/自然/通用)、`star`(4/5/6)、`q`、`recommended=1`、`limit`、`offset`
`GET /api/v1/operators/{name}`	单个干员完整配装，中文名或英文名均可，如 `/api/v1/operators/汤汤`
`GET /api/v1/teams`	配队，支持 `element`、`operator`（含该干员的队伍）、`q`
`GET /api/v1/versions`	1.0–1.6 各版本非 UP 角色装备变动（含替换 / 未换及原因）
`GET /api/v1/changelog`	手册自身更新日志
`GET /api/v1/search?q=涉渊`	全站搜索：干员 / 流派 / 装备 / 武器 / 配队
`GET /api/v1/health`	健康检查
`GET /api/v1/openapi.json`	OpenAPI 3.0 描述，可直接喂给工具 / AI 自动生成调用

二、调用示例

// JavaScript（浏览器 / Node 均可，已开启 CORS）
const r = await fetch('/api/v1/operators/汤汤');
const op = await r.json();
console.log(op.builds[0].equipment);

// Python
import requests
op = requests.get('https://你的域名/api/v1/operators/汤汤').json()
for b in op['builds']:
    print(b['letter'], b['title'], b['equipment'], b['weapon'])

# curl
curl "http://127.0.0.1:8080/api/v1/operators?element=冰&star=6"

三、数据字段

字段	含义
`operators[].name / name_full`	中文名 / 带英文全名
`operators[].element / star / role / position`	属性、星级、定位、站位职责
`builds[].letter / title`	流派编号（A/B/C…）与流派名
`builds[].equipment / weapon`	装备（如「清波重甲 + 清波手甲 + …」）与武器（按首选 ▶ 次选排列）
`builds[].recommended`	是否为血狼 / 梦轩明确推荐的流派
`builds[].basis`	依据版本，如 `1.2+1.6`＝1.2 起配装、1.6 有装备替换
`builds[].updated_from / updated_to / updated_ver`	版本替换的旧件 → 新件及版本
`builds[].sources / source_bv`	来源文案与 BV 号数组（可直接拼 B 站链接）
`teams[].core[].operator / duty / alternates`	队伍核心位、该位职责、可替换干员
`versions[].replacements / not_changed`	该版本「替换」与「评估后未换」的明细

四、使用条款（请遵守）

允许：程序 / AI 读取、索引、引用、二次整理，做攻略工具、问答机器人、数据看板都可以。
要求：注明来源「数据整理自 B 站 @血狼破军 / @梦轩dada 的终末地视频，汇总：终末地养成手册」；引用 BV 号时保留原样。
禁止：商用售卖、把数据包装成自家原创、伪造来源或篡改 BV 号、对本站发起高频抓取（限流 120 次/分钟/IP）。
免责：数据来自 UP 主视频与官方 WIKI 的人工整理，仅供参考；游戏版本更新后可能滞后，以游戏内为准。

五、频率与缓存

项目	规则
限流	同一 IP 120 次 / 分钟，超出返回 `429`
缓存	响应带 `Cache-Control: public, max-age=300`，建议客户端缓存 5 分钟
CORS	`Access-Control-Allow-Origin: *`，支持浏览器直连
压缩	public.json 约 100 KB，整包一次取回也很快