公共API

Bitdefender 控制中心 API允许开发者实现业务流程自动化

这些API通过 JSON-RPC 2.0协议 进行交互

以下是更新公司名称的API调用示例 控制中心 :

{
        "id": "91d6430d-bfd4-494f-8d4d-4947406d21a7",
        "jsonrpc": "2.0",
        "method": "updateCompanyDetails",
        "params": {
            "name": "我的公司名称"
        }
    }

针对此调用，系统会向应用程序返回以下响应：

{
        "id":"91d6430d-bfd4-494f-8d4d-4947406d21a7",
        "jsonrpc":"2.0",
        "result": null
    }

每个API调用都针对一个方法并传递一组参数。

参数分为两种类型：

API调用通过HTTP请求执行，以JSON-RPC消息作为负载。每个API调用必须使用HTTP POST方法。此外，每个HTTP请求必须将 Content-Type 请求头设置为 application/json .

控制中心 提供针对产品不同领域的多个API。每个API公开与指定产品领域相关的一组方法。

所有API的基础URL为： CONTROL_CENTER_APIs_ACCESS_URL/v1.0/jsonrpc/ 。完整API URL由基础URL加上API名称构成。

该 CONTROL_CENTER_APIs_ACCESS_URL 显示在 访问URL 字段中。要找到该字段，请点击 控制台右上角的用户图标并选择 我的账户 。进入 控制中心 API部分 .

当前公开的API如下：

可通过向每个API URL发送包含JSON RPC 2.0的HTTP请求来调用相应功能。

API密钥是在 我的账户 板块中生成的唯一密钥，该板块位于 控制中心 内。每个API密钥允许应用程序调用一个或多个API公开的方法。生成API密钥时可选择允许访问的API。

生成API密钥步骤：

1. 登录 https://gravityzone.bitdefender.com/ （需使用管理员账户），该账户需具备以下权限： 管理网络 , 管理用户 , 管理公司 以及 查看分析数据 .

2. 点击控制台右上角的用户名，选择 我的账户 :

   

3. 前往 API密钥 部分，点击 添加 按钮：

   

4. 输入密钥描述并选择要为此密钥启用的API：

   

5. 点击 生成 .

   注意

   将显示一个包含新生成API密钥的窗口，并警告该密钥仅在窗口打开时可查看。关闭窗口后，您将无法在 GravityZone .

   

6. 点击 按钮将密钥复制到剪贴板并保存至安全位置。

7. 关闭 API密钥 窗口。

新密钥将以模糊形式添加到 API密钥 部分，同时显示其描述、创建日期及已启用API列表。

控制中心 还允许您删除不再需要的API密钥：

对 控制中心 的API调用通过HTTP协议层进行认证，采用 HTTP基本认证 机制（详见 此处 .

客户端应用每次调用API时都需发送Authorization请求头。

该 Authorization 请求头包含以下要素：

控制中心 当请求的API方法无法执行所需任务时，会返回错误。

以下是一个失败API调用的错误响应示例：

{
          "id":"4d77e2d9-f760-4c8a-ba19-53728f868d98",
          "jsonrpc" : "2.0",
          "error" : {
              "code" : -32601,
              "message" : "方法未找到",
              "data" : {
                  "details" : "所选API不可用。"
              }
          }
      }

错误代码和错误消息按照 JSON-RPC 2.0规范 :

错误的完整描述存放在 data.details 错误消息的成员中。

此外，HTTP状态码会根据错误类型进行设置：