标识与命名规则

标识由前缀、主体段、用途段和校验段组成。标识在登记时确定,主体名称、端点或授权范围变化时通过记录版本更新,标识本身保持不变,调用方按完整标识发起解析,登记前应核对字符、用途和校验规则。

标识组成

一个完整标识由四段组成,段与段之间用冒号分隔。前缀说明标识类型,主体段说明登记主体,用途段说明服务场景,校验段用于检查标识是否完整。四段共同构成可核对的唯一字符串。

段作用规则
前缀区分标识类型使用固定小写前缀,不随主体变化
主体段对应登记主体由登记系统分配,不由调用方自行填写
用途段说明服务场景使用登记时确认的用途代码,长度 2 至 12 位
校验段检查标识完整性按登记规则生成,不手工修改

字符与唯一性

标识只使用小写字母、数字和冒号,不使用空格、汉字、下划线、斜杠和大小写混写。主体段和用途段合在一起后必须唯一;重复提交时,系统返回已有标识,不新建第二条记录。

  • 长度:完整标识不超过 64 个字符。
  • 大小写:统一使用小写,提交前由系统转换。
  • 保留用途段:以 test、demo、temp 开头的用途段不进入正式登记。
  • 分配方式:主体段由登记系统分配,调用方不自行填写。
  • 生成方式:校验段按规则生成,不手工修改。

版本与变更

记录版本从 1 开始,端点、授权范围、联系人发生变化时版本递增。标识、主体段和校验段不随业务变化修改,变更通过记录版本体现。

提交变更时说明变更事项、影响范围和生效方式。登记节点核对后生成新版本,解析按新版本返回端点与授权范围。旧版本保留在记录中,供核对使用。

涉及用途变化的,登记新标识,旧标识按停用处理。把新用途写入原标识会造成用途与记录不一致,登记节点不予通过。

登记节点在分配主体段前核对主体材料和用途说明。用途代码由登记时确认,调用方不自行编写;需要新增用途的,按新标识登记,不沿用旧用途段。

停用与注销

停用表示暂停解析,记录仍然保留;注销表示标识退出服务,注销后不再返回端点,原标识不复用。两种状态都需要主体提交说明。

停用和注销都会写入变更记录,调用方按记录编号可核对状态变化。主体重新提供服务时,应按新登记或恢复流程办理,不直接使用旧凭据。

  • 停用:说明暂停原因和影响范围,恢复后版本继续递增。
  • 注销:确认无未结事项后办理,调用方应停止请求。
  • 恢复:只适用于停用标识,注销标识不恢复。
  • 记录:停用、恢复和注销都写入变更记录。

常见错误

提交前按登记规则自查,可以减少退回。多数退回与字符格式、用途代码和校验段有关。

  • 提交大写字母:系统转换为小写后判断是否重复。
  • 用途段与登记用途不一致:退回修改,不进入解析。
  • 手工修改校验段:标识校验失败,解析返回格式错误。
  • 重复提交同一主体和用途:返回已有标识和当前版本。

查看解析方式

标识登记完成后,调用方按标识发起解析,取得端点、状态和记录版本。

查看解析流程