API 的工作原理
API 调用类型
ESET PROTECT On-Prem API 中支持 GET、POST 和 DELETE 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 |