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 取自 Web 主控台):
方法 |
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 |