API 작동 방식
API 호출 유형
GET, POST 및 DELETE API 호출 유형은 ESET PROTECT On-Prem API에서 사용할 수 있습니다.
•GET 호출은 입력 파라미터를 포함하며(본문이 없음) URL에서 직접 데이터를 전송합니다. 요청 호출은 수정할 수 없으며 실행할 수만 있습니다.
•POST 호출에는 요청 본문이 필요합니다. 각 POST 호출에 대한 파라미터가 문서화되어 있습니다.
•페이지 매김(page_size)을 포함하는 API 요청에서는 기본 페이지 크기가 100이며, 최대 크기는 10000입니다.
각 호출은 다음으로 구성됩니다.
•호출 유형
•요청 URL
•요청 헤더(인증 토큰으로 구성될 수 있음)
•요청 본문(특히 POST 호출의 경우 데이터 포함)
서버 응답 구조
각 API 호출은 REST 서버로부터 응답을 받습니다. 응답은 서버 응답 코드와 JSON 데이터 형식으로 된 응답으로 구성됩니다.
응답은 다음으로 구성됩니다.
•서버 코드
•응답 본문
•응답 헤더
API 호출의 예시
GET
정책 표시(Policy_UUID는 웹 콘솔에서 가져옴):
방법 |
GET |
함수 |
|
URL |
https://protect_server:9443/v2/policies/Policy_UUID |
본문 |
|
권한 부여 |
Bearer token |
POST
장치를 특정 정적 그룹으로 이동(URL에 컴퓨터 ID가 포함됨):
방법 |
POST |
함수 |
|
URL |
https://protect_server:9443/v1/devices/a13f7d4c-e689-47cb-939d-91b9c9664a57:move |
본문 |
{ "newParentUuid": "be3d7451-e625-47fb-8f29-f98d61b40db1" } |
권한 부여 |
Bearer token |