Cognos Analytics访问/api/api-docs返回404及接口不全问题咨询

• IBM从Cognos Analytics 11.1.7版本开始调整了服务默认上下文根路径，原根路径下的/api端点被统一迁移到/bi上下文路径下，你参考的是11.1.0版本的旧文档路径，和你实际部署的版本不匹配，所以直接访问根路径下的/api/api-docs会返回404。
• 如果你在部署时自定义过服务的上下文根前缀，也需要将对应前缀替换到/bi的位置，再拼接API路径访问。

默认/bi/api/api-docs仅展示基础通用接口，要展示所有可用接口，按以下步骤操作即可：

1. 使用管理员账号登录Cognos Analytics管理控制台，进入配置标签页，打开系统设置面板
2. 搜索Advanced properties配置项，新增自定义参数：
   参数名：cognos.restapi.showAllApis
   参数值：true
3. 找到Enable all REST API endpoints配置项，将开关调整为启用状态
4. 保存所有配置后重启Cognos Analytics服务实例，重启完成后再次访问http://<cognos_analytics_server:port>/bi/api/api-docs即可看到完整的接口列表

你反馈的404错误截图符合版本不匹配导致的路径不存在报错特征，按上述方案调整即可。

内容的提问来源于stack exchange，提问作者Salman Khan