ADDC7.3API指导文档

ADDC7.3 就是 SeerEngine‑DC 控制组件，对外提供RESTful 北向 API，没有对外公网直接下载的公开 PDF 版《API 开发指南》H3C。

1、API 文档获取 3 种途径（按优先级）

方式①：控制器内置 Swagger 在线 API 文档（现场最常用）

控制器北向端口默认30000，浏览器访问：

输入控制器账号密码，即可在线查看全部 API 接口、入参出参、示例，可直接在线调试接口。 ⚠️注意：防火墙需要放行服务器 30000 端口 TCP 访问权限。

方式②：向 H3C 技术支持 / 办事处申请正式 API 文档

完整的 REST API 开发手册属于合作伙伴 / 项目交付资料，不对外公开下载。 1）通过 400‑810‑0504 开 case，提供现场 ADDC7.3 版本号，申请《SeerEngine‑DC REST API 开发指南》； 2）也可以联系本地 H3C 办事处交付工程师获取对应版本文档包。

配套资源：还可以索要 Ansible、Terraform 插件包，插件内部也附带接口调用样例H3C。

方式③：官方文档中心参考对接类手册

H3C 官网文档中心可以下载对接插件手册（OpenStack 插件、Ansible 插件安装指导），里面会有部分 API 调用样例，但不是完整全量 API 参考手册。

2、API 基础信息

1. 访问端口：默认TCP 30000（北向业务 IP，集群填虚拟北向 IP）
2. 认证方式：账号密码 token 鉴权；
3. 支持能力：创建 / 删除租户网络、子网、VPC、VLAN‑VXLAN 映射、查询设备、查询 EVPN 路由等；
4. 注意：部分运维、Fabric 底层配置接口不对外开放，仅内部使用。

3、重要限制 & 踩坑点

1. swagger 内置文档就是实际可调用接口，但是部分接口仅供 Web 页面内部调用，不建议业务二次开发使用，开发前请咨询 H3C 确认接口是否对外支持；
2. 版本强绑定：ADDC7.3 (E710x) 的 API 不能直接套用 7.2/6.0 文档，接口存在变更，必须拿对应大版本文档；
3. 不要直接复制 web 抓包的接口用于开发，部分内部接口版本升级会发生变化。

4、快速排错验证

访问 swagger 页面不通：

1. 确认防火墙放通30000端口；
2. 使用集群北向业务虚 IP，不要用单台节点物理 IP；
3. 确认用户角色具备network‑admin权限，普通用户看不到完整 swagger 接口。

简短总结

ADDC7.3 没有公网可直接下载的 API 手册；优先登录控制器IP:30000/swagger看内置在线 API 文档；需要完整 PDF 开发手册，联系 H3C400 或办事处索取项目对应版本资料。

400要一下的 

需要从官网的软件下载栏目里下载ADDC的版本包获取API接口文档

ADDC方案的API指导文档获取方式取决于您所管理的控制器类型，主要分为以下几种情况：

1. 对于 iMC/Director 平台：iMC 提供了第三方 API 接口，可通过两种方式查看手册。其一，在线访问 iMC 软件自带页面说明，地址为 http://IP_ADDR:PORT/imcrs/，其中 IP_ADDR 为前台登录地址，PORT 为端口（默认HTTP为8080，HTTPS为8443），登录账号密码与登录 iMC Web 界面一致，登录后可在“用户指南”中查看详细的 API 对接介绍 。其二，H3C 官网也提供 REST 接口 web 版说明 。此外，iMC-PLAT 的 API 文档（如用户指南）通常包含在安装包中，压缩包路径如 H3C_iMC_PLAT_7.3_E0506_Standard-Windows\windows\install\components\iMC-PLAT\client\client.zip\client\web\apps\imcrs\userguide，部署后的对应路径为 C:\Program Files\iMC\client\web\apps\imcrs\userguide 。

2. 对于 VCFC 控制器：目前关于 VCFC 的 Java API 仅有官方手册这一份详细说明文档，没有额外的更详细的中文补充资料 。

3. 关于 AD-DC 系列配置文档：AD-DC 6.5、7.1、7.2 等版本的配置指导手册（如 ）主要侧重于功能配置和流程，不直接包含 API 开发指导。若您需要 ADDC 场景下与 iMC 或 Director 的 API 对接，请优先参考上文第 1 点中的在线 API 界面或官网文档。