跳至主内容

获取公司详情

此方法用于获取公司详细信息。

参数

参数

类型

可选

描述

公司ID

字符串

公司ID。默认值为生成API密钥的用户关联的公司ID。

返回值

该方法返回一个包含所选公司详细信息的对象:

  • type - 公司类型:0代表合作伙伴,1代表客户

  • name - 公司名称

  • id - 公司ID

  • address - 公司地址

  • phone - 公司电话

  • canBeManagedByAbove - 公司的安全管理状态: true ,若安全设置可由上级公司管理

  • enforce2FA - 布尔值,表示是否对所选公司的用户账户强制执行双因素认证(2FA)

  • skip2FAPeriod - 整数,表示用户登录时可免于提供双因素认证码的天数期限

  • isSuspended - 公司账户状态: true ,若公司处于暂停状态

  • createdAt - 字符串,表示公司创建时的UTC日期和时间

  • country - 字符串,表示国家代码,格式为 ISO 3166 。若未指定代码,则字符串值为 N/A

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

  • 行业 - 表示公司所属行业的字符串。其取值可为下列之一:

    • 0 - 未定义

    • 1 - 航空航天

    • 101 - 航空航天制造

    • 102 - 航空航天技术研究

    • 2 - 农业

    • 201 - 农业化学品与肥料

    • 202 - 农作物与动物生产

    • 203 - 农业机械

    • 204 - 种植业

    • 205 - 渔业

    • 206 - 林业

    • 207 - 农业_狩猎

    • 208 - 农业_农产品

    • 3 - 艺术_娱乐

    • 301 - 艺术_娱乐_文化活动

    • 302 - 艺术_娱乐_赌博

    • 4 - 汽车

    • 401 - 汽车_卡车_摩托车零部件

    • 402 - 汽车_机械

    • 403 - 汽车_制造商

    • 404 - 汽车_市场营销

    • 5 - 商业协会

    • 6 - 化学品

    • 7 - 商业服务

    • 701 - 商业服务_兽医

    • 8 - 企业集团

    • 9 - 建筑

    • 901 - 建筑_土木工程

    • 902 - 建筑_房屋建筑

    • 903 - 建筑_承包商

    • 904 - 建筑_工程

    • 905 - 建筑_材料

    • 906 - 建筑_专业化

    • 907 - 建筑_公用事业系统

    • 10 - 咨询

    • 11 - 容器_包装:

    • 12 - 国防

    • 1201 - 国防_造船_航空

    • 1202 - 国防_航天

    • 13 - 教育_研究

    • 1301 - 教育_研究_科学研究与开发

    • 14 - 能源

    • 1401 - 能源设备与技术

    • 1402 - 能源基础设施

    • 1403 - 能源石油天然气及消耗性燃料

    • 1404 - 能源可再生能源

    • 15 - 工程

    • 16 - 金融服务

    • 1601 - 金融服务银行

    • 1602 - 金融服务多元化

    • 1603 - 金融服务保险

    • 1604 - 金融服务投资

    • 1605 - 金融服务房地产

    • 17 - 食品饮料

    • 18 - 政府

    • 1801 - 地方政府

    • 1802 - 政府_国家

    • 1803 - 政府_私营承包商

    • 1804 - 政府_公共行政与国防

    • 1805 - 政府_公共服务

    • 1806 - 政府_区域

    • 19 - 医疗保健

    • 1901 - 医疗保健_设备服务

    • 1902 - 医疗保健_制药_生物技术_生命科学

    • 1903 - 医疗保健_研究

    • 20 - 酒店餐饮_休闲娱乐

    • 2001 - 酒店餐饮_休闲娱乐_酒店_汽车旅馆_邮轮

    • 2002 - 酒店餐饮_休闲娱乐_休闲娱乐

    • 2003 - 酒店餐饮_休闲娱乐_餐厅酒吧

    • 21 - 制造业

    • 2101 - 制造业_基础金属

    • 2102 - 制造业_饮料

    • 2103 - 制造业_化学产品

    • 2104 - 制造业_电气设备

    • 2105 - 制造业_电子产品

    • 2106 - 制造业_金属制品

    • 2107 - 制造业_食品

    • 2108 - 制造业_家具

    • 2109 - 制造业_机械设备

    • 2110 - 制造业_机动车辆

    • 2111 - 制造业_非金属矿物制品

    • 2112 - 制造业_纸制品

    • 2113 - 制造业_石油产品

    • 2114 - 制造业_医药产品

    • 2115 - 制造业_纺织品

    • 2116 - 制造业_烟草

    • 2117 - 制造业_交通运输

    • 2118 - 制造业_服装服饰

    • 2119 - 制造业_木材加工

    • 22 - 海洋产业

    • 23 - 传媒业

    • 2301 - 传媒业_广告营销

    • 2302 - 传媒业_广播电视

    • 2303 - 传媒业_娱乐

    • 2304 - 传媒业_出版

    • 24 - 采矿业

    • 2401 - 采矿业_煤炭和褐煤

    • 2402 - 采矿业_金属矿石

    • 2403 - 采矿业_石油和天然气

    • 2404 - 采矿业_贵金属

    • 2405 - 采矿业_采石

    • 2406 - 采矿服务

    • 25 - 非营利组织

    • 26 - 律师事务所

    • 27 - 纸制品与林产品

    • 28 - 零售

    • 2801 - 零售饮料

    • 2802 - 零售书籍与报刊

    • 2803 - 零售建筑材料

    • 2804 - 零售服装店

    • 2805 - 零售分销商

    • 2806 - 零售电子购物

    • 2807 - 零售电子产品

    • 2808 - 零售加油站

    • 2809 - 零售家居用品

    • 2810 - 零售奢侈品店

    • 2811 - 零售_多品类零售

    • 2812 - 零售_个人护理用品店

    • 2814 - 零售_超市

    • 2815 - 零售_日用品商店

    • 2816 - 零售_车辆销售

    • 29 - 支持服务活动

    • 2901 - 支持服务活动_商业支持

    • 2902 - 支持服务活动_就业服务

    • 2903 - 支持服务活动_维修服务

    • 2904 - 支持服务活动_租赁服务

    • 2905 - 支持服务活动_安保与调查

    • 2906 - 支持服务活动_社会援助

    • 2907 - 支持服务活动_旅行社

    • 30 - 科技

    • 3001 - 科技_人工智能

    • 3002 - 技术_电子设备与元件

    • 3003 - 技术_硬件

    • 3004 - 技术_IT服务

    • 3005 - 技术_安全

    • 3006 - 技术_半导体与半导体设备

    • 3007 - 技术_软件

    • 31 - 电信服务

    • 3101 - 电信服务_通信基础设施

    • 3102 - 电信服务_综合电信

    • 3103 - 电信服务_无线通信

    • 32 - 交通运输

    • 3201 - 交通运输_航空运输

    • 3202 - 交通运输_深海、沿海及五大湖水域运输

    • 3203 - 交通运输_普通货运卡车运输

    • 3204 - 交通运输_基础设施

    • 3205 - 交通运输_内河运输

    • 3206 - 交通运输_管道运输

    • 3207 - 交通运输_邮政与快递

    • 3208 - 交通运输_铁路运输

    • 3209 - 交通运输_公路运输

    • 3210 - 交通运输_观光旅游

    • 3211 - 交通运输_城市公交系统

    • 3212 - 交通运输_水上运输

    • 33 - 公用事业

    • 3301 - 公用事业_电力燃气

    • 3302 - 公用事业_供水

    • 34 - 批发

    • 3401 - 批发_服装

    • 3402 - 批发_饮料

    • 3403 - 批发_建筑材料

    • 3404 - 批发化学品

    • 3405 - 批发药品

    • 3406 - 批发电子市场

    • 3407 - 批发电子产品

    • 3408 - 批发农产品

    • 3409 - 批发食品杂货

    • 3410 - 批发家居用品

    • 3411 - 批发金属和矿物

    • 3412 - 批发非耐用品

    • 3413 - 批发石油

    • 3414 - 批发用品

    • 3415 - 批发车辆

    默认值: 0 .

  • 联系人 - 包含以下联系人详细信息的对象 GravityZone :

    • fullName ,其名字与姓氏

    • email ,其商务邮箱地址

    • phoneNumber ,其商务电话号码

    • companyRole ,其在公司中的职位

    Note

    若该对象下任意字段有值,则所有字段均会被返回,无论其是否被赋值。

  • mdrContactInformation ——包含MDR联系人详细信息的对象:

    • fullName ,其名字与姓氏

    • email ,其商务邮箱地址

    • phoneNumber ,其商务电话号码

  • riskScore ——包含以下公司安全风险信息的对象:

    • value ,公司安全风险评分百分比值。该值细分为配置错误、应用漏洞、人为风险,并经健康行业修正因子调整

    • impact ,公司安全风险影响等级(低、中、高)

    • misconfigurations ,配置错误在公司安全风险评分中的占比

    • appVulnerabilities ,应用漏洞在公司安全风险评分中的占比

    • humanRisks ,人为风险在公司安全风险评分中的占比

    • industryModifier ,根据环境中发现的已在行业层面被利用的CVE动态调整公司评分

  • customFields - 包含公司自定义字段值的对象:

    • 自定义字段名称1 ,自定义字段值1,

    • 自定义字段名称2 ,自定义字段值2

  • parentCompanyId - 包含公司合作伙伴ID的整数。

示例

请求 :

{
  "params": {"companyId": "5493dcd2b1a43df00b7b23c6"},
  "jsonrpc": "2.0",
  "method": "getCompanyDetails",
  "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810"
}

响应 :

{
      "id":"0df7568c-59c1-48e0-a31b-18d83e6d9810",
      "jsonrpc":"2.0",
      "result": {
          "type": 1,
          "name": "示例有限公司",
          "id": "54aeab40b1a43dc0467b23e9",
          "address": "示例街1号",
          "phone": "0040740000001",
          "canBeManagedByAbove": true,
          "enforce2FA": true,
          "skip2FAPeriod": 3
          "isSuspended": false,
          "createdAt": "2017-01-28T15:01:15",
          "country": "CA",
          "state": "CA-BC",
          "industry": 2,
          "contactPerson": {
              "fullName": "史蒂芬·约翰逊",
              "email": "stephen.jhonsons@example.email.com",
              "phoneNumber": "0040740000001",
              "companyRole": "所有者/总裁"
          },
          "mdrContactInformation": {
              "phoneNumber": {
                  "countryPrefix": "+4",     
                  "subscriberNumber": "112345"
              },
              "fullName": "联系人",
              "email": "mdrcontact@nebula.local",
              "emailVerificationCode": "43728676"
          },"customFields": {
              "referenceID":"004562",
              "vertical":"医疗保健",
              "partner_type":"白金",
              "security_level":"高",
              "payment_status":"良好"
           },"riskScore": {
                "value": "87%",
                "impact": "高",
                "misconfigurations": "70%",
                "appVulnerabilities": "11%",
                "humanRisks": "19%",
                "industryModifier": "6%"},
           "parentCompanyId": "54aeab40b1a43dc0467b23e9"
      }
  }