配置模板
网站和业务配置模板。
查询系统配置列表
查询主控配置记录列表,仅管理员可调用。可按作用域名称、作用域 ID、配置类型和配置名称组合筛选;scope_name 支持用英文逗号传入多个值。返回配置原始 value 字符串,不会按配置类型自动解析 JSON。
新增或更新主控配置
按“作用域 + 类型 + 名称”创建或更新主控配置。服务端会将 value 转为字符串保存,并按具体 type、name 校验值;Nginx、错误页、OpenResty、默认端口和节点配置等变更会创建节点同步任务。仅管理员可调用。
删除指定非全局主控配置
删除路径复合标识对应的 region 或 node 作用域配置。全局配置不能通过此接口删除;即使未找到记录,符合格式的删除请求仍会成功返回。删除 nginx_config、error_page、openresty_config 或 site.listen-default-http-80 时会创建对应范围的节点同步任务。仅管理员可调用。
查询单项主控配置
按作用域、类型和名称组成的复合标识读取一条主控配置。登录用户只可读取 site 类型的 clean_url、clean_dir、ip-unlock-max-limit、ip-unlock-max-per-limit、pre_cache_url,以及 system 类型的 recharge;其余标识要求管理员身份。普通用户读取 recharge 时不会取得支付密钥,仅取得默认支付方式和转账说明。
按标识新增或更新主控配置
从路径复合标识取得 scope_name、scope_id、type、name,并以请求体的 value、enable 写入配置。路径中不存在的配置会被创建,已存在的配置会更新;请求体中的同名定位字段会被路径值覆盖。具体 type、name 可能触发同步任务和额外校验。仅管理员可调用。
获取站点系统配置
读取全局 OpenResty 配置中供站点使用的默认临时白名单时长和封禁时长。接口要求登录,不区分普通用户与管理员。