Appearance
应用管理
功能需求表
| 序号 | 功能需求 | 需求描述 | 功能说明 | 校验规则 | 交互说明与流程 | 涉及字段 | 错误提示 | 成功提示 |
|---|---|---|---|---|---|---|---|---|
| 1 | 应用名称展示 | 展示当前配置所属的应用名称 | 用于标识当前配置归属的应用,该字段为只读不可编辑,由后端生成(可采用UUID或后端自定义规则),字符串格式且全局唯一 | 无(展示字段,非交互项) | 页面加载完成后,自动从服务端拉取并渲染当前应用名称 | 应用名称(application_name) | - | - |
| 2 | IP白名单配置 | 配置允许发起接口调用的服务器IP地址或网段 | 支持配置单个IP、IP前缀网段,多个值之间用英文半角逗号分隔;输入 0.0.0.0 表示关闭IP限制,允许所有IP访问 | 1. 输入内容需为合法的IPv4地址或网段格式; 2. 多个IP/网段必须使用英文半角逗号 ,分隔;3. 特殊值 0.0.0.0 格式合法,无需校验其他规则 | 1. 页面加载时,输入框回显当前已配置的白名单; 2. 用户编辑内容后,点击页面"保存"按钮触发校验与提交; 3. 校验通过则更新配置,校验不通过则在输入框下方展示错误提示 | IP白名单(ip_whitelist) | 1. 格式错误:"请输入正确的IP地址或网段,多个条目用英文半角逗号分隔"; | 成功 |
| 3 | 秘钥修改 | 更新应用调用接口的安全秘钥 | 输入秘钥 参考文档: https://www.jianshu.com/p/d1bd1dba23a3 | 1. 新秘钥需满足8-32位,且包含字母与数字的组合; 2. 提交时需校验用户操作权限 | 提交成功后,页面刷新展示新的脱敏秘钥 | 秘钥(secret_key) | 1. 格式错误:"请设置8-32位字母与数字组合的秘钥"; | 信息配置成功 |
| 4 | 回调地址配置 | 配置接口调用结果的异步回调接收地址 | 用于接收服务端返回的异步通知,该字段支持为空,为空时不触发回调 | 1. 若输入内容,需为合法的URL格式(支持http/https); 2. 输入为空时,直接校验通过 | 1. 页面加载时,回显当前已配置的回调地址; 2. 用户编辑后,点击"保存"按钮触发校验与提交; 3. 校验不通过时,在输入框下方展示错误提示 | 回调地址(callback_url) | 1. 格式错误:"请输入合法的回调地址URL"; | 信息配置成功 |
提示信息表
| 场景 | 提示类型 | 提示内容 |
|---|---|---|
| 信息配置成功 | Success | 信息配置成功 |
| IP格式错误 | Error | 请输入正确的IP地址格式 |
| 回调地址格式错误 | Error | 请输入正确的URL格式 |
| 网络异常 | Error | 网络异常,请稍后重试 |