Ucenter api

一、先说重点：官网文档中心没有公开 PDF 版 OpenAPI 手册

二、4 种获取接口文档的途径（按优先级排序）

方式 1：平台内置 Swagger 在线文档（首选，可调试接口）

前提：使用system 超级管理员登录，普通租户账号无权限

1. 访问 U-Center 首页：https://UCENTER_IP:8443
2. 菜单路径：系统 → API 管理
   • 页面内可以创建 API 凭证（ClientID/Secret、令牌有效期）
   • 页面内置【OpenAPI 文档】跳转入口，打开 Swagger UI
3. 备选直接地址（E0715 通用）

• 部分 E0715 早期补丁版本，swagger 地址需要先开启集成服务；
• 防火墙放行 8443 端口；浏览器需要信任平台自签名证书。

方式 2：联系 H3C 售后 / 400 获取离线开发手册

1. 提供设备序列号、版本 E0715、项目信息，提单 400 热线；
2. 或者联系当地 H3C 办事处售前 / 售后工程师，索取《U-Center 2.0 OpenAPI 开发手册》PDF。
   手册包含：鉴权流程、告警 API、资源查询 API、CMDB 接口、批量操作示例。

方式 3：知了社区检索现成接口示例

方式 4：抓包前端接口（兜底方案）

三、E0715 API 关键基础信息（避坑）

1. 鉴权模式：OAuth2.0，通过 client_id+client_secret 获取 access_token，所有业务接口携带 token；
2. 区分两套接口：
   • 平台 OpenAPI（对外集成推荐）：/api/v1/ 标准开放接口；
   • 前端内部接口：/rest/ 不保证版本兼容，升级可能失效，开发不要使用；
3. E0715 相比后续 E0722：少量指标接口、CMDB 字段存在差异，不要直接照搬高版本文档。

四、常见问题

1. 找不到【API 管理】菜单
   → 必须 system 账号；集群部署需要在主节点访问；部分轻量化安装包默认未启用 API 微服务，需要后台开启。
2. swagger 页面打不开
   → 检查ucenter-api-gateway容器运行状态，登陆 matrix 页面查看服务实例。