API相关文档建议修订一下

龚佶敏    50  

{{ttag.title}}
本帖最后由 龚佶敏 于 2026-10-29 17:56 编辑

版本号:AC13.0.121.001 Build20260324
打算对接API查某个用户的IP信息,对着文档研究好久发现几个坑。
1、文档中API对接认证信息设置界面的截图里面有个认证用户,并且POST请求要求带上name参数。实际上AC的设置界面里面没有认证用户这个输入框,而且实测不需要name参数。
2、文档中提到“random为client请求时随机生成的字串,且同一random,1小时内只能使用1次,否则权限校验不通过”。我琢磨随机还不能重复,那就用UUID字符串吧,结果一直返回“{"code":1,"message":"Data format of interface is incorrect."}”这个信息也没说具体是什么问题,还以为请求的接口或BODY里面的各种过滤字段拼错了。最后研究发现对于某些请求,random必须是数字(文档中没有写),某些请求(比如获取版本号)random可以是UUID字符串。
3、/v1/user查不到信息(可能因为LDAP认证,问题是文档里面没有提)。换成/v1/online-users才查到。
目前还不知道随机数长度有什么限制,打算继续测试。
这些问题找客服也交流了一阵子。客服也说“之前已经反馈过了,现在还没人力去改”,希望官方能重视一下。

和楼主有同感吗?赶快顶起来助力研发哥快速完善!

发表的建议被采纳即可获得100-1000S豆不等,如果您在建议专区表现活跃,可获得产品顾问荣誉勋章!了解更多S豆奖励信息

完善手机号和公司名称,让服务更省心更便捷!立即完善

七嘴八舌bar  发表于 2026-10-30 10:56
  
感谢反馈,上述问题产线文档质量管理部门已经在处理,预计下一版本优化
发表新帖
热门标签
全部标签>
深小服案例集
信服课堂视频
知识大闯关
新版本体验
2026年技术争霸赛
每日一问
功能体验
纪元平台
安装部署配置
标准化排查
终端接入
【 社区to talk】
每周精选
GIF动图学习
产品连连看
畅聊IT
答题自测
专家问答
技术笔记
技术圆桌
在线直播
MVP
网络基础知识
升级
安全攻防
上网策略
测试报告
日志审计
问题分析处理
流量管理
每日一记
运维工具
用户认证
原创分享
解决方案
sangfor周刊
VPN 对接
项目案例
SANGFOR资讯
专家分享
技术顾问
信服故事
SDP百科
功能咨询
授权
设备维护
资源访问
地址转换
虚拟机
存储
迁移
排障笔记本
产品预警公告
玩转零信任
S豆商城资讯
技术争霸赛
「智能机器人」
追光者计划
2023技术争霸赛专题
卧龙计划
华北区拉练
天逸直播
以战代练
秒懂零信任
技术晨报
平台使用
技术盲盒
山东区技术晨报
文档捉虫
齐鲁TV
华北区交付直播
2024年技术争霸赛
北京区每日一练
场景专题
故障笔记
排障那些事
西北区每日一问
高手请过招
升级&主动服务
高频问题集锦
社区新周刊
POC测试案例
全能先锋系列
安全效果
云化安全能力
专家说
热门活动
产品动态
行业实践
产品解析
关键解决方案
2025年技术争霸赛
声音值千金
工具体验官
产品知识周周练
产品体验官
有一说一
VMware替换
王者破雾峡谷
课后茶话社
案例实践挑战
大规模VMware迁移替代
破雾实践案例
畅聊深小服
深小服

本版版主

127
276
306

发帖

粉丝

关注

5
10
6

发帖

粉丝

关注

本版达人

新手89785...

本周建议达人

七嘴八舌bar

本周分享达人

新手76619...

本周提问达人