版本 2.1.1792967583 · 最新 下载 OpenAPI Markdown 版

线路

节点组里的一条解析记录:节点按哪条 DNS 解析线路、多少权重出现在组里;删除前须先停用。

lines节点调度鉴权: 仅管理员5 个接口

列出线路

GET/api/v2/lines
鉴权: 仅管理员

查询参数

字段类型必填说明
pageinteger— 页码,从 1 开始。
默认 1
page_sizeinteger— 每页条数。
默认 20
sortstring— 排序字段,逗号分隔,前缀 `-` 表示降序,如 `-created_at,id`。

创建线路

POST/api/v2/lines
鉴权: 仅管理员

请求体 application/json

字段类型必填说明
dns_linestring— DNS 解析线路代码(default = 默认线路;运营商/地区线路代码由 DNS 域映射)。
enabledboolean— 是否启用
forceboolean— 强制写入,跳过两道保护(须二次确认):线路成为启用的主线路时节点须已装上配置、比该装的版本落后不超过 1 版(否则 422 node_config_behind);停用或转备用组里最后一条启用的主线路(否则 422 last_primary_line)。
is_backupboolean— 备用 IP:平时不进解析,按节点组的备用 IP 切换方式自动启用/撤下。
is_backup_defaultboolean— 备用默认解析:节点组里没有在用的默认线路时,这条线路自动改按默认线路解析,有了再改回原线路。
node_group_idinteger必填 所属节点组的 id。
node_idinteger必填 节点 ID
weightinteger— 权重,1 到 100,越大分到的解析越多。

获取线路

GET/api/v2/lines/{id}
鉴权: 仅管理员

修改线路

PUT/api/v2/lines/{id}
鉴权: 仅管理员

请求体 application/json

字段类型必填说明
dns_linestring— DNS 解析线路代码(default = 默认线路;运营商/地区线路代码由 DNS 域映射)。
enabledboolean— 是否启用
forceboolean— 强制写入,跳过两道保护(须二次确认):线路成为启用的主线路时节点须已装上配置、比该装的版本落后不超过 1 版(否则 422 node_config_behind);停用或转备用组里最后一条启用的主线路(否则 422 last_primary_line)。
is_backupboolean— 备用 IP:平时不进解析,按节点组的备用 IP 切换方式自动启用/撤下。
is_backup_defaultboolean— 备用默认解析:节点组里没有在用的默认线路时,这条线路自动改按默认线路解析,有了再改回原线路。
node_group_idinteger— 所属节点组的 id。
node_idinteger— 节点 ID
weightinteger— 权重,1 到 100,越大分到的解析越多。

删除线路

DELETE/api/v2/lines/{id}
鉴权: 仅管理员

线路对象

字段类型必填说明
backup_default_onboolean— 备用默认解析当前已启用、正按默认线路解析(只读,由定时任务维护)。
只读
backup_onboolean— 备用 IP 当前已启用进解析(只读,由定时任务维护)。
只读
created_atstring— 创建时间
只读
disable_bystring— 停用来源(manual 管理员手工、monitor 节点监控、bandwidth 带宽超限等);启用时为空。
dns_linestring— DNS 解析线路代码(default = 默认线路;运营商/地区线路代码由 DNS 域映射)。
enabledboolean— 是否启用
forceboolean— 强制写入,跳过两道保护(须二次确认):线路成为启用的主线路时节点须已装上配置、比该装的版本落后不超过 1 版(否则 422 node_config_behind);停用或转备用组里最后一条启用的主线路(否则 422 last_primary_line)。
idinteger— 记录 ID
只读
is_backupboolean— 备用 IP:平时不进解析,按节点组的备用 IP 切换方式自动启用/撤下。
is_backup_defaultboolean— 备用默认解析:节点组里没有在用的默认线路时,这条线路自动改按默认线路解析,有了再改回原线路。
node_group_idinteger— 所属节点组的 id。
node_idinteger— 节点 ID
updated_atstring— 更新时间
只读
weightinteger— 权重,1 到 100,越大分到的解析越多。