|
|
|
|
验证
开始 VSA API Web 服务会话的必需条件。返回的 SessionID 必须在会话期间每种方法均被调用的情况下提交。仅当会话 ID 接收自发出验证的计算机时才有效。
将返回以下字段的单个记录。
SessionID |
小数 |
分配给与目标 URL 进行的用户连接的唯一会话 ID。 |
Method |
字符串 |
请求此响应的操作。 |
TransactionID |
小数 |
此消息的唯一消息 ID。 |
ErrorMessage |
字符串 |
如果为空，表示未返回错误。 |
ErrorLocation |
字符串 |
如果为空，表示未返回错误。 |
验证期间自动登录
通过 API 进行验证时，还会自动登录到 VSA。如果在验证时已登录到 VSA，则这两个会话是同步的。 无论怎样，结果都是相同的，即在两种环境下均以有效的会话结束。
VSA 会在每个 VSA 页面的查询字符串上查找 API 的 26 位 SessionID。因此，如果应用程序开发人员需要重定向至 VSA 页面，则现在可以直接到达页面，而无需强制用户再次登录。语法为：
URL?apiLogonGuid=12345678901234567890123456
例如：
http://someServer:123/Systemtab/SomePage?apiLogonGuid=12345678901234567890123456&SomeVar=SomeValue
API 活动会保持 VSA 会话处于活动状态。但是，由于 VSA 不假定始终需要 API 会话，因此 VSA 活动不会保持 API 会话处于活动状态。
API 使用与 VSA 相同的超时值，该值使用 VSA 的“系统”>“登录策略”页面进行维护，其系统默认值为 30 分钟。