GET /version
엔드포인트: GET /v1/pdapi/version
인증: Bearer 토큰
필요 권한: REST.Version.Read
용도
도구, 대시보드, 스크립트에서 API 작동 여부와 버전을 확인할 때 사용하세요.
경로 매개변수
없습니다.
쿼리 매개변수
없습니다.
요청 본문
요청 본문은 없습니다.
응답 스키마
200 응답 스키마
| 필드 | 자료형 | 설명 |
|---|---|---|
Version |
객체 | PalDefender 버전 상세 정보입니다. |
Version 객체 스키마:
| 필드 | 자료형 | 설명 |
|---|---|---|
Major |
정수 | 주 버전 번호입니다. |
Minor |
정수 | 부 버전 번호입니다. |
Patch |
정수 | 패치 버전 번호입니다. |
Build |
정수 | 빌드 번호입니다. |
Version |
문자열 | 짧은 버전 문자열입니다. |
VersionLong |
문자열 | 전체 버전 문자열입니다. |
Beta |
불리언 | 베타 빌드로 표시되어 있는지 나타냅니다. |
오류 응답
오류 응답 본문은 다음 형식을 사용합니다:
| HTTP | 오류 코드 | 발생 조건 |
|---|---|---|
401 |
INVALID_TOKEN |
Authorization 헤더가 없거나 형식이 잘못되었거나, 설정된 Bearer 토큰과 일치하지 않습니다. |
403 |
MISSING_PERMISSION |
토큰은 유효하지만 이 엔드포인트에 필요한 권한이 없습니다. |
예제
작동 여부 및 버전 확인
활용 사례
- REST API 토큰 설정 후 인증이 정상적으로 작동하는지 확인합니다.
- 도구가 특정 PalDefender 버전 이상을 요구한다면 다른 엔드포인트 호출 전에 확인합니다.
- 가장 작은 읽기 전용 요청이므로 모니터링에 사용합니다.