Next Topic

Previous Topic

Book Contents

驗證

要求啟動 VSA API Web 服務會話，返回的 SessionID 必須在會話期間每種方法均被調用的情況下提交，僅當會話 ID 接收自發出驗證的電腦時才有效。

系統將返回以下欄位的單個記錄。

SessionID

decimal

分配給與目標 URL 進行的使用者連接的唯一會話 ID。

Method

string

請求此回應的作業。

TransactionID

decimal

此訊息的唯一訊息 ID。

ErrorMessage

string

如果為空，則系統不會返回錯誤。

ErrorLocation

string

如果為空，則系統不會返回錯誤。

驗證期間自動登入

通過 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 分鐘。