主要参考 深信服应用交付AD 接口文档&日志说明&版本排障_V7.0.21 中API文档
发现API文档中似乎有个问题:文档中所有调用URL 都是 /api/ad/v3/xxxx 的形式,但是实际上不能有中间的“ad/v3/”,应该为 /api/xxxx 才对,否则调用一定会失败。
要想通过API对AD进行操作,必须先获取有效的token。而token是有有效期的,默认是10分钟,10分钟后就失效了。有两个疑问:
1. 如何来延长token的有效期?(不是通过Web管理界面中来指定API超时的时长) 从API文档中,我猜想应该是通过 /api/ad/v3/refresh-token 更新指定的会话令牌。但API的说明有误,按照它的说明调用是失败的,我最接近成功的调用是URL为/api/refresh-token,HEADER中提供x-token-sangforad,POST body中以json格式提供token的name,但是调用总是返回“Token资源不存在”。
2. 如何删除token? 每次执行完任务,获取的这个token就没用了,我发现只有具有“超级管理”权限的账号才能去删除token,否则自己创建的token,自己是无法删除的。其实我是要做一个自动化的脚本,每天上班时自动打开一些虚拟服务,到下班时再去关闭这些虚拟服务。如果定时脚本无法删除自己的token,日积月累肯定后在系统中留下一大堆无用的token的。
希望有经验的高手能给指导一下。
最后再抱怨一下这API的文档:写的实在是太差了,远不如原来7.0.5老版本的文档,至少老文档还讲一下基本的调用步骤流程,给一些范例。
|