|
|
|
|
Authenticate
VSA API 웹 서비스를 시작하기 위해 필요. 반환된 SessionID 는 세션이 진행되는 동안 호출된 모든 방법으로 전송해야 합니다. SessionID는 인증이 생성된 것과 동일한 컴퓨터에서 받은 경우에만 유효합니다.
다음 필드에 대한 단일의 기록이 반환됩니다.
SessionID |
십진수 |
사용자와 대상 URL의 연결에 할당된 고유의 session ID. |
Method |
문자열 |
이 응답을 요청한 작업. |
TransactionID |
십진수 |
이 메시지에 대한 고유 메시지 ID. |
ErrorMessage |
문자열 |
이 옵션을 선택하지 않으면, 어떠한 오류도 반환되지 않았습니다. |
ErrorLocation |
문자열 |
이 옵션을 선택하지 않으면, 어떠한 오류도 반환되지 않았습니다. |
인증을 하는 동안 자동 로그온
API를 통해 인증하는 경우에는 마찬가지로 VSA에 자동으로 로그인됩니다. 인증할 때 이미 VSA에 로그인한 상태라면 2개의 세션이 동기화됩니다. 어느 쪽이든 결과는 동일하며, 두 세계에서 모두 유효한 세션으로 끝이 납니다.
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분의 시스템 기본값을 가지고 있습니다.