接入前准备什么
- 主体证明与联系人信息,用于确认接入主体与通知对象。
- 节点标识、服务能力与端点,用于建立可被选择的候选节点。
- 请求类型、返回字段与授权范围,用于权限过滤。
- 路由策略与备选路径,用于排序与切换。
- 健康检查方式与需要保存的日志字段,用于运行与核对;日志字段按接入约定保留。材料按清单准备,减少退回补充。
接入步骤
五步按顺序办理:提交材料后核对主体、节点与授权范围;节点登记后确认端点可访问;策略配置完成后先用测试请求验证选择结果;联调通过再启用正式流量。
测试未通过前不使用正式流量。节点端点或策略变化按变更流程提交,不需要重新接入。
- 提交主体和节点材料,确认材料齐备。
- 登记节点,配置能力与状态,明确区域与授权范围。
- 配置路由策略和备选路径,确定优先级与切换条件。
- 使用测试请求验证路径选择和切换,覆盖授权边界。
- 测试通过后启用正式流量,按约定配额调用。
材料如何核对
| 材料 | 内容 | 用途 |
|---|---|---|
| 主体证明 | 主体名称与登记证明 | 确认接入主体 |
| 节点信息 | 节点标识、端点与区域 | 建立候选节点 |
| 能力与授权 | 服务能力、请求类型、授权范围 | 筛选与权限过滤 |
| 策略与备选 | 策略条件与备选路径 | 决定排序与切换 |
| 联系人 | 姓名、部门与联系方式 | 接收变更与通知 |
接入后变更怎么办
| 变化 | 办理方式 | 是否重新接入 |
|---|---|---|
| 节点端点变化 | 提交端点变更 | 否 |
| 能力变化 | 更新能力说明 | 否 |
| 策略变化 | 提交策略变更 | 否 |
| 节点停用 | 提交停用说明 | 否,保留记录 |
| 节点注销 | 提交注销说明 | 是,标识不复用 |
联调测试看什么
测试请求用于验证路径选择与切换。可以覆盖同区域与跨区域、授权内与授权外、主路径可用与不可用几种情况,确认返回结果与选择原因符合预期。测试请求只使用测试流量,不携带真实业务正文。
测试未通过前不进入正式流量。发现问题时先核对节点状态与策略版本,再决定是修改配置还是补充材料。修改完成后重新验证,确认路径与切换均符合预期。联调通过后保留测试记录,便于正式启用后对照。
启用后如何运行
正式启用后按约定配额调用。节点状态由运营人员或健康检查更新,策略变更保留版本与生效时间,路径选择与切换写入记录。策略变更与节点状态变化都保留记录,便于按时间核对。启用初期可以先观察路径与切换记录,再逐步扩大调用范围。
接入方需要指定联系人接收变更与故障通知。节点停用保留记录,节点注销需要重新接入,标识不再复用。联系人变化也需要更新,避免变更通知无法送达;接入后定期核对登记信息与实际运行是否一致。接入方按清单准备,可以减少补充次数。接入后按约定周期核对记录。