办理对象与阶段划分
企业、机构与智能体开发方首次使用服务时,都从主体接入开始。主体记录建立后,才能登记标识并设置授权;顺序颠倒时,核验无法确认标识归属。
主体接入与标识登记属于首次接入的前置事项;端点变更、授权管理、记录查询与注销退出在接入后按需办理。接入后可以单项办理,也可以按项目合并办理,材料分别准备。
办理前先确认当前处于哪个阶段。阶段判断错误,材料会按错误事项准备,核验时退回补充,整体办理时间也会延长。
六项服务的先后关系
先后关系来自依赖,不来自编号。主体记录是标识登记的前提,标识是授权与端点变更的对象,注销则要求业务已经停止使用相关标识与服务。
接入后的四项事项互相独立,可以并行准备,但提交时按事项分开。授权与端点变更同时提交时,写明生效顺序,避免调用方按旧范围访问新端点。
| 阶段 | 服务事项 | 前置条件 | 办理结果 |
|---|---|---|---|
| 首次接入 | 主体接入 | 主体证明与联系人 | 主体记录与接入凭证 |
| 首次接入 | 标识登记 | 主体记录已建立 | 标识、记录版本与端点 |
| 接入后 | 授权管理 | 标识已登记 | 授权记录与回执 |
| 接入后 | 端点变更 | 标识已登记 | 更新后的端点与版本 |
| 接入后 | 记录查询 | 主体或授权调用方 | 调用记录与授权结果 |
| 退出 | 注销退出 | 业务已停止使用 | 注销状态与记录 |
首次接入的办理顺序
首次接入不跳步。主体记录未建立时提交标识登记,核验无法确认归属;标识未登记时设置授权,授权缺少对象;信息不一致时,退回补充会涉及多份材料。
顺序清楚后,材料准备也有依据。共同材料先备齐,再按事项补充能力清单、服务端点与授权范围,提交时逐项对应。
- 确认业务场景、使用对象与责任部门。
- 准备营业执照或登记证明、联系人与用途说明。
- 提交主体接入,取得主体记录与接入凭证。
- 按实际用途登记标识,提交能力清单与服务端点。
- 取得标识、记录版本与端点后,再按需办理授权管理。
多项事项合并办理
可以一次办理多个事项,但材料按事项分别准备,提交时逐项列明。材料混在一份文件里,核验时难以对应事项,退回后也不清楚该补哪一项。
材料较多时先办理主体接入与标识登记,取得标识后再办理授权与端点事项,减少一次提交的核对量。有依赖关系的事项按顺序提交,不并行跳过前置。
- 每个事项单独列出材料清单与联系人。
- 共用材料只提交一次,注明适用事项。
- 有先后依赖的事项按顺序提交,不跳过前置。
- 合并办理时在提交说明中写明事项名称与顺序。
- 授权与端点变更同时提交时,写明生效顺序。
各项事项的办理要点
每项事项的核验关注点不同。主体接入看主体资格与名称一致性,标识登记看唯一性与端点可达,端点变更看新旧对应,授权管理看范围边界,记录查询看查询用途,注销看业务是否停止。
核验关注点写在材料里,比事后解释更有效。端点可达性、授权期限与名称一致性都可以在提交前自查。
| 事项 | 关键材料 | 核验关注 | 结果使用 |
|---|---|---|---|
| 主体接入 | 营业执照或登记证明、联系人、用途说明 | 主体名称一致、证明在有效期 | 取得接入凭证 |
| 标识登记 | 标识用途、能力清单、服务端点 | 标识唯一、端点可达 | 取得标识与端点 |
| 端点变更 | 变更说明、新端点、生效时间 | 原端点与新端点对应 | 按新端点解析 |
| 授权管理 | 授权对象、可访问信息、期限 | 范围在主体确认边界内 | 按授权范围调用 |
| 记录查询 | 查询范围、时间区间、用途 | 查询范围不超授权 | 核对请求与授权 |
| 注销退出 | 注销说明、数据处理方式 | 业务已停止、联系人确认 | 标识不再复用 |
办理结果怎么使用
主体接入的结果是主体记录与接入凭证,用于后续登记标识与办理授权。接入凭证按主体与用途签发,不写入前端代码与公开仓库,也不通过聊天工具明文传递。
标识登记的结果是标识、记录版本与端点。调用方按标识检索与解析,服务地址变化后重新解析,不使用旧地址;版本用于核对变更前后的内容。
授权管理的结果是授权记录与回执。授权范围内的调用可以继续,撤回后相关调用停止,已产生的记录按接入时确认的保存期限保留。
沟通、补充与边界
材料不完整或信息不一致时按通知补充,补充后重新核验。办理进度以受理通知为准,不用口头说明替代材料;联系人需要能够接收核验、变更与故障通知。
平台提供接入办理与服务说明,不代替主体业务系统处理请求,不保存业务正文,不保证业务结果。检索与解析只返回授权范围内的字段,记录查询只返回与用途相关的记录。
变更通过对应事项办理,原记录保留,便于追溯。注销后标识不再复用,需要恢复使用时按首次接入重新办理。
- 可以先登记标识再办主体接入吗
- 不可以。标识归属需要主体记录支撑,顺序不能颠倒。
- 一次办理多个事项需要重复提交共同材料吗
- 不需要。共同材料提交一次并注明适用事项即可。
- 接入后新增用途需要重新接入吗
- 不需要。按新用途登记标识并办理授权,主体记录继续有效。