跳至主内容

按用户获取公司详情

该方法用于获取与指定用户名关联的公司详细信息。

参数

参数

类型

可选

描述

用户名

字符串

否

与所查询公司关联的用户名。

密码

字符串

是

指定用户名对应的密码。仅当被查询公司不属于API调用用户的目标公司时，此参数为必填项。

返回值

该方法返回一个包含被查询公司详细信息的对象：

  • 类型 - 数字类型，表示公司类型：0代表合作伙伴，1代表客户

  • 名称 - 字符串类型，表示公司名称

  • ID - 字符串类型，显示公司在 GravityZone系统中的标识码

  • 地址 - 字符串类型，显示公司经营场所的物理地址

  • 电话 - 字符串类型，提供公司联系电话

  • 可由上级管理 - 布尔类型，表示对公司的安全管理权限。当 true 时表示Bitdefender合作伙伴管理被查询公司的安全事务，否则为false

  • 强制双因素认证 - 布尔类型，指定被查询公司的用户账户是否强制启用双因素认证(2FA)

  • 双因素认证豁免期 - 整型，指定用户登录时可免于提供双因素认证码的天数时长

  • 是否停用 - 布尔类型，反映公司账户状态。当值为 true 时表示公司账户已被停用

  • 创建时间 - 字符串类型，表示公司创建的UTC日期和时间

  • 国家 - 表示国家代码的字符串，采用 ISO 3166 格式。若未指定代码，则该字符串值为 N/A

  • 州/省 - 表示国家州/省代码的字符串，采用 ISO 3166 格式。若未指定代码，则该字符串值为 N/A

  • 联系人 - 包含联系人详细信息的对象：

    • 全名 ，其名字与姓氏

    • 电子邮箱 ，其商务邮箱地址

    • 电话号码 ，其商务电话号码

    • 公司职务 ，其在公司中的职位

  • MDR联系人信息 - 包含MDR联系人详细信息的对象：

    • 全名 ，其名字与姓氏

    • 电子邮箱 ，其商务邮箱地址

    • 电话号码 ，其商务电话号码

  • 自定义字段 - 包含为所查询公司配置的自定义字段集合及其关联值的对象

示例

请求 : 

{
       "params": {
           "username": "partner@bitdefender.com",
           "password": "password"
       },
       "jsonrpc": "2.0",
       "method": "getCompanyDetailsByUser",
       "id": "6435c228-73b0-4e72-9a2a-8716cc58c883"
  }

响应 : 

{
      "id":"6435c228-73b0-4e72-9a2a-8716cc58c883",
      "jsonrpc":"2.0",
      "result": {
          "type": 0,
          "name": "测试合作伙伴",
          "id": "550ac840b1a43da64d7b23c6",
          "address": "示例街1号",
          "phone": "0040740000001",
          "canBeManagedByAbove": true,
          "enforce2FA": true,
          "skip2FAPeriod": 1,
          "isSuspended": false,
          "createdAt": "2017-01-28T15:01:15",
          "country": "加拿大",
          "state": "不列颠哥伦比亚省",
          "contactPerson": {
              "fullName": "斯蒂芬·约翰逊",
              "email": "stephen.jhonsons@example.email.com",
              "phoneNumber": "0040740000001",
              "companyRole": "所有者/总裁"
          },
          "mdrContactInformation": {
              "phoneNumber": "+40332434452",
              "fullName": "联系人",
              "email": "mdrcontact@nebula.local"
          },
          "customFields":{
              "referenceID":"004562",
              "vertical":"医疗保健",
              "partner_type":"白金",
              "security_level":"高",
              "payment_status":"良好"
          }
      }
  }
本节内容 :