Gerege Verify (XYP)¶
Production · 第 2 层 — 查询 ·
仓库：sso-gerege-mn（xyp.gerege.mn/） · xyp.gerege.mn
对照国家登记信息核验企业与机构资料的查询服务。由 Go API 与 Next.js 管理界面组成。
它做什么？¶
生态系统内的平台在创建机构、添加成员、授予权限时，往往需要确认该机构在国家 登记中确实存在。Gerege Verify 以单一窗口提供这类查询。
常见用途：
- 机构是否已登记，名称与登记号是否一致；
- 机构的法定授权人员是谁；
- 某位公民是否与该机构存在关联。
组成结构¶
| 部分 | 技术 | 职责 |
|---|---|---|
api/ |
Go | 查询 API、client / API key 管理、用量计数 |
web/ |
Next.js | 管理控制台——client 注册、用量报表 |
API 结构¶
| 路径 | 用途 |
|---|---|
/v1/* |
主查询 API——带限流 |
/api/clients |
client 注册（管理员） |
/api/usage |
用量遥测（管理员） |
/health |
健康检查 |
访问由 API key 控制。每个 client 各持一把密钥，用量会被计数并在管理界面 中展示。
为什么计数很重要？
国家登记查询可能是收费且有配额的数据源。若不按 client 分别计数， 既无法分摊成本，也无法发现超额。此外还有审计要求：必须能追溯谁查询了 哪家机构的信息。
谁在使用？¶
- Gerege Platform 与 Template Platform——用于创建/检索机构的流程；
- Gerege Wallet——用于机构账户流程；
- 内部管理工具。
与 X-Road 的关系¶
从长期看，机构间查询正朝着在 X-Road 上标准化的方向发展。 Gerege Verify 目前是与 X-Road 并行运行的查询通道——待 X-Road 全面落地后， 部分查询可能迁移过去。
详细文档¶
实现文档位于 sso-gerege-mn 仓库的 xyp.gerege.mn/ 目录中。