飞书开放平台 Server API 文档

主题

更新公司 ​

更新公司信息，包括基本信息、注册地址、办公地址等

Tip: - 非必填字段，不传时即不做变更

  • 如果传入生效时间当天不存在版本则会自动生成一个版本。
  • 如果传入生效时间当天存在版本则会修改该版本。

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/corehr/v1/companies/:company_id
HTTP MethodPATCH
接口频率限制100 次/分钟
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用corehr:corehr 更新核心人事信息

请求头 ​

名称类型必填描述
Authorizationstring是tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Typestring是固定值："application/json; charset=utf-8"

路径参数 ​

名称类型描述
company_idstring需要更新的公司 ID。ID获取方式： - 调用【创建公司】【批量查询公司】等接口可以返回部门ID
示例值："6863333352603125255"

查询参数 ​

名称类型必填描述
client_tokenstring否根据client_token是否一致来判断是否为同一请求
示例值：fe599b60-450f-46ff-b2ef-9f6675625b97

请求体 ​

名称类型必填描述
hiberarchy_commonhiberarchy_common否组织实体公共字段，包括名称、描述、上级、启停用状态、生效日期、编码等基础信息
  └ parent_idstring否上级组织
示例值："4719168654814483759"
  └ namei18n\[\]否公司名称 - 名称不能包含「/」「；」「;」「\」「'」字符。 - 公司中英文名称会有全局唯一校验
    └ langstring是语言，支持中文和英文。中文用zh-CN；英文用en-US。
示例值："zh-CN"
    └ valuestring是内容，支持中文和英文
示例值："xx有限科技公司"
  └ activeboolean否是否启用该公司
示例值：true
  └ effective_timestring是版本生效日期 - 填写格式：YYYY-MM-DD 00:00:00（系统会自动将时分秒改为00:00:00） - 系统默认为填写日期当天的 00:00:00 生效 - 该接口只支持到最小单位为日 - 日期范围要求:1900-01-01 00:00:00～9999-12-31 23:59:59
示例值："2020-05-01 00:00:00"
  └ codestring否公司编码 (不能与其他记录的编码重复)，如果不传值则不更新
示例值："12456"
  └ descriptioni18n\[\]否描述
    └ langstring是语言，支持中文和英文。中文用zh-CN；英文用en-US。
示例值："zh-CN"
    └ valuestring是内容，支持中文和英文。
示例值："xx有限科技公司"
typeenum否公司性质，通过获取字段详情查询获取。请求参数：object_api_name=company；custom_api_name=type。
  └ enum_namestring是枚举值
示例值："private_owned"
industry_listenum\[\]否所在行业，通过获取字段详情查询获取。请求参数：object_api_name=company；custom_api_name=industry。
  └ enum_namestring是枚举值
示例值："professional_technique_service"
legal_representativei18n\[\]否法定代表人 - 仅注册地址中的 国家 / 地区 为中国大陆时，法人字段填入才有效。 - 若注册地址中的 国家 / 地区 不为中国大陆时，则填入法人字段无效。 - 不是分公司时，法人字段填入才有效。 - 是分公司时，填入法人字段无效。
  └ langstring是语言，支持中文和英文。中文用zh-CN；英文用en-US。
示例值："zh-CN"
  └ valuestring是内容，支持中文和英文。
示例值："张三"
post_codestring否邮编（该字段已废弃，可忽略）
示例值："100000"
tax_payer_idstring否纳税人识别号
示例值："123456840"
confidentialboolean否是否保密，该功能暂不支持，可以忽略
示例值：true
sub_type_listenum\[\]否公司主体类型，通过获取字段详情查询获取。请求参数：object_api_name=company；custom_api_name=subtype。
  └ enum_namestring是枚举值
示例值："company"
branch_companyboolean否是否为分公司 - 是分公司时，主要负责人生效。 - 不是分公司时，法定代表人生效。
示例值：true
primary_manageri18n\[\]否主要负责人 - 是分公司时，该字段填入才有效。 - 不是分公司时，填入该字段无效。
  └ langstring是语言，支持中文和英文。中文用zh-CN；英文用en-US。
示例值："zh-CN"
  └ valuestring是内容，支持中文和英文。
示例值："张三"
currencycurrency否默认币种
  └ currency_namei18n\[\]否货币名称
    └ langstring是语言，支持中文和英文。中文用zh-CN；英文用en-US。
示例值："zh-CN"
    └ valuestring是内容，支持中文和英文
示例值："xx科技有限公司"
  └ numeric_codeint否对应币种的指代代码，通过系统内部查找，通过查询货币信息v2查询获取。
示例值：12
  └ currency_alpha_3_codestring否法定货币对应代码，如CNY 、USD等.通过查询货币信息v2查询获取。
示例值："CNY"
phonephone_number_and_area_code否电话
  └ area_codeenum是区号对应的数字，可通过 获取字段详情查询获取。请求参数：object_api_name=phone；custom_api_name=international_area_code。
示例值：123123
    └ enum_namestring是区号对应名称
示例值："86_china"
  └ phone_numberstring是号码
示例值："213213"
faxphone_number_and_area_code否传真
  └ area_codeenum是区号对应的数字，可通过 获取字段详情查询获取。请求参数：object_api_name=phone；custom_api_name=international_area_code。
示例值：123123
    └ enum_namestring是区号对应的名称
示例值："86_china"
  └ phone_numberstring是号码
示例值："213213"
registered_office_address_infoaddress否注册地址详细信息。公共字段，若请求对象为公司，则该字段必填。
  └ country_region_idstring是国家 / 地区 ID。各国家/地区填写字段可参考地址填写规则查询。可通过 查询国家/地区信息查询获取。
示例值："6862995757234914824"
  └ region_idstring否主要行政区ID.可通过 查询省份/主要行政区信息查询获取。
示例值："6863326815667095047"
  └ city_idstring否城市ID.可通过 查询城市信息查询获取。
示例值："6863333254578046471"
  └ distinct_idstring否区/县ID.可通过 查询区/县信息查询获取。
示例值："6863333516579440141"
  └ address_line1string否地址行 1
示例值："丹佛测试地址-纽埃时区"
  └ address_line2string否地址行 2
示例值："PoewH"
  └ address_line3string否地址行 3
示例值："PoewH"
  └ address_line4string否地址行 4
示例值："jmwJc"
  └ address_line5string否地址行 5
示例值："jmwJc"
  └ address_line6string否地址行 6
示例值："jmwJc"
  └ address_line7string否地址行 7
示例值："jmwJc"
  └ address_line8string否地址行 8
示例值："rafSu"
  └ address_line9string否地址行 9
示例值："McPRG"
  └ local_address_line1string否地址行 1（非拉丁语系的本地文字）
示例值："丹佛测试地址-纽埃时区"
  └ local_address_line2string否地址行 2（非拉丁语系的本地文字）
示例值："PoewH"
  └ local_address_line3string否地址行 3（非拉丁语系的本地文字）
示例值："PoewH"
  └ local_address_line4string否地址行 4（非拉丁语系的本地文字）
示例值："jmwJc"
  └ local_address_line5string否地址行 5（非拉丁语系的本地文字）
示例值："jmwJc"
  └ local_address_line6string否地址行 6（非拉丁语系的本地文字）
示例值："jmwJc"
  └ local_address_line7string否地址行 7（非拉丁语系的本地文字）
示例值："jmwJc"
  └ local_address_line8string否地址行 8（非拉丁语系的本地文字）
示例值："rafSu"
  └ local_address_line9string否地址行 9（非拉丁语系的本地文字）
示例值："McPRG"
  └ postal_codestring否邮政编码
示例值："611530"
office_address_infoaddress否办公地址详细信息。公共字段，若请求对象为公司，则该字段必填。
  └ country_region_idstring是国家 / 地区 ID。各国家/地区填写字段可参考地址填写规则查询.可通过 查询国家/地区信息查询获取。
示例值："6862995757234914824"
  └ region_idstring否主要行政区ID.可通过 查询省份/主要行政区信息查询获取。
示例值："6863326815667095047"
  └ city_idstring否城市ID.可通过 查询城市信息查询获取。
示例值："6863333254578046471"
  └ distinct_idstring否区/县ID.可通过 查询区/县信息查询获取。
示例值："6863333516579440141"
  └ address_line1string否地址行 1
示例值："丹佛测试地址-纽埃时区"
  └ address_line2string否地址行 2
示例值："PoewH"
  └ address_line3string否地址行 3
示例值："PoewH"
  └ address_line4string否地址行 4
示例值："jmwJc"
  └ address_line5string否地址行 5
示例值："jmwJc"
  └ address_line6string否地址行 6
示例值："jmwJc"
  └ address_line7string否地址行 7
示例值："jmwJc"
  └ address_line8string否地址行 8
示例值："rafSu"
  └ address_line9string否地址行 9
示例值："McPRG"
  └ local_address_line1string否地址行 1（非拉丁语系的本地文字）
示例值："丹佛测试地址-纽埃时区"
  └ local_address_line2string否地址行 2（非拉丁语系的本地文字）
示例值："PoewH"
  └ local_address_line3string否地址行 3（非拉丁语系的本地文字）
示例值："PoewH"
  └ local_address_line4string否地址行 4（非拉丁语系的本地文字）
示例值："jmwJc"
  └ local_address_line5string否地址行 5（非拉丁语系的本地文字）
示例值："jmwJc"
  └ local_address_line6string否地址行 6（非拉丁语系的本地文字）
示例值："jmwJc"
  └ local_address_line7string否地址行 7（非拉丁语系的本地文字）
示例值："jmwJc"
  └ local_address_line8string否地址行 8（非拉丁语系的本地文字）
示例值："rafSu"
  └ local_address_line9string否地址行 9（非拉丁语系的本地文字）
示例值："McPRG"
  └ postal_codestring否邮政编码
示例值："611530"

请求体示例 ​

json
{
    "hiberarchy_common": {
        "parent_id": "4719168654814483759",
        "name": [
            {
                "lang": "zh-CN",
                "value": "xx有限科技公司"
            }
        ],
        "active": true,
        "effective_time": "2020-05-01 00:00:00",
        "code": "12456",
        "description": [
            {
                "lang": "zh-CN",
                "value": "xx有限科技公司"
            }
        ]
    },
    "type": {
        "enum_name": "private_owned"
    },
    "industry_list": [
        {
            "enum_name": "professional_technique_service"
        }
    ],
    "legal_representative": [
        {
            "lang": "zh-CN",
            "value": "张三"
        }
    ],
    "post_code": "100000",
    "tax_payer_id": "123456840",
    "confidential": true,
    "sub_type_list": [
        {
            "enum_name": "company"
        }
    ],
    "branch_company": true,
    "primary_manager": [
        {
            "lang": "zh-CN",
            "value": "张三"
        }
    ],
    "currency": {
        "currency_name": [
            {
                "lang": "zh-CN",
                "value": "xx科技有限公司"
            }
        ],
        "numeric_code": 12,
        "currency_alpha_3_code": "CNY"
    },
    "phone": {
        "area_code": {
            "enum_name": "86_china"
        },
        "phone_number": "213213"
    },
    "fax": {
        "area_code": {
            "enum_name": "86_china"
        },
        "phone_number": "213213"
    },
    "registered_office_address_info": {
        "country_region_id": "6862995757234914824",
        "region_id": "6863326815667095047",
        "city_id": "6863333254578046471",
        "distinct_id": "6863333516579440141",
        "address_line1": "丹佛测试地址-纽埃时区",
        "address_line2": "PoewH",
        "address_line3": "PoewH",
        "address_line4": "jmwJc",
        "address_line5": "jmwJc",
        "address_line6": "jmwJc",
        "address_line7": "jmwJc",
        "address_line8": "rafSu",
        "address_line9": "McPRG",
        "local_address_line1": "丹佛测试地址-纽埃时区",
        "local_address_line2": "PoewH",
        "local_address_line3": "PoewH",
        "local_address_line4": "jmwJc",
        "local_address_line5": "jmwJc",
        "local_address_line6": "jmwJc",
        "local_address_line7": "jmwJc",
        "local_address_line8": "rafSu",
        "local_address_line9": "McPRG",
        "postal_code": "611530"
    },
    "office_address_info": {
        "country_region_id": "6862995757234914824",
        "region_id": "6863326815667095047",
        "city_id": "6863333254578046471",
        "distinct_id": "6863333516579440141",
        "address_line1": "丹佛测试地址-纽埃时区",
        "address_line2": "PoewH",
        "address_line3": "PoewH",
        "address_line4": "jmwJc",
        "address_line5": "jmwJc",
        "address_line6": "jmwJc",
        "address_line7": "jmwJc",
        "address_line8": "rafSu",
        "address_line9": "McPRG",
        "local_address_line1": "丹佛测试地址-纽埃时区",
        "local_address_line2": "PoewH",
        "local_address_line3": "PoewH",
        "local_address_line4": "jmwJc",
        "local_address_line5": "jmwJc",
        "local_address_line6": "jmwJc",
        "local_address_line7": "jmwJc",
        "local_address_line8": "rafSu",
        "local_address_line9": "McPRG",
        "postal_code": "611530"
    }
}

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ companycompany公司
    └ idstring公司ID
    └ hiberarchy_commonhiberarchy_common公司基本信息，该结构维护了公司的名称、编码、启用状态、上级公司等基础信息。
      └ parent_idstring上级组织
      └ namei18n\[\]名称
        └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
        └ valuestring内容，支持中文和英文。
      └ typeenum组织类型，枚举值可通过文档【飞书人事枚举常量】组织类型（organization_type）枚举定义部分获得
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
          └ valuestring内容，支持中文和英文
      └ activeboolean公司启用状态，true为启用，false为停用
      └ effective_timestring版本生效日期 - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59
      └ expiration_timestring版本失效日期 - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59
      └ codestring公司编码
      └ descriptioni18n\[\]描述
        └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
        └ valuestring内容，支持中文和英文
      └ tree_orderstring树形排序，代表同层级的部门排序序号（该功能暂不支持，可忽略）
      └ list_orderstring列表排序，代表所有部门的混排序号（该功能暂不支持，可忽略）
      └ custom_fieldsobject_field_data\[\]自定义字段（该功能暂不支持）
        └ field_namestring字段名
        └ valuestring字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ typeenum公司性质，通过获取字段详情查询获取。请求参数：object_api_name=company；custom_api_name=type。
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
        └ valuestring内容，支持中文和英文
    └ industry_listenum\[\]所在行业，通过获取字段详情查询获取。请求参数：object_api_name=company；custom_api_name=industry。
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
        └ valuestring内容，支持中文和英文
    └ legal_representativei18n\[\]法定代表人 - 仅注册地址中的 国家 / 地区 为中国大陆时，法人字段填入才有效。 - 若注册地址中的 国家 / 地区 不为中国大陆时，则填入法人字段无效。 - 不是分公司时，法人字段填入才有效。 - 是分公司时，填入法人字段无效。
      └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
      └ valuestring内容，支持中文和英文
    └ post_codestring邮编（该字段已废弃，可忽略）
    └ tax_payer_idstring纳税人识别号
    └ confidentialboolean是否保密（该字段暂不支持，可忽略）
    └ sub_type_listenum\[\]公司主体类型，通过获取字段详情查询获取。请求参数：object_api_name=company；custom_api_name=subtype。
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
        └ valuestring内容，支持中文和英文
    └ branch_companyboolean是否为分公司 - 是分公司时，主要负责人生效。 - 不是分公司时，法定代表人生效。
    └ primary_manageri18n\[\]主要负责人 - 是分公司时，该字段填入才有效。 - 不是分公司时，填入该字段无效。
      └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
      └ valuestring内容，支持中文和英文
    └ custom_fieldsobject_field_data\[\]自定义字段（该功能暂不支持）
      └ field_namestring字段名
      └ valuestring字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ currencycurrency默认币种
      └ idstring货币id
      └ country_region_idstring货币所属国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得
      └ currency_namei18n\[\]货币名称
        └ langstring货币语言，支持中文和英文。中文用zh-CN；英文用en-US。
        └ valuestring货币内容，支持中文和英文
      └ numeric_codeint对应币种的指代代码，通过系统内部查找，通过查询货币信息v2
      └ currency_alpha_3_codestring法定货币对应代码，如CNY 、USD等.通过查询货币信息v2
    └ phonephone_number_and_area_code电话
      └ area_codeenum区号对应的数字，可通过 获取字段详情查询获取。请求参数：object_api_name=phone；custom_api_name=international_area_code。
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
          └ valuestring内容，支持中文和英文
      └ phone_numberstring号码
    └ faxphone_number_and_area_code传真
      └ area_codeenum- 电话区号 通过获取字段详情查询获取。请求参数：object_api_name=phone；custom_api_name=international_area_code。
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
          └ valuestring内容，支持中文和英文
      └ phone_numberstring号码
    └ registered_office_addressi18n\[\]完整注册地址（该字段暂不返回，可忽略） - 调用【查询单个公司】【批量查询公司】等接口可以返回完整注册地址
      └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
      └ valuestring内容，支持中文和英文
    └ office_addressi18n\[\]完整办公地址（该字段暂不返回，可忽略） - 调用【查询单个公司】【批量查询公司】等接口可以返回完整办公地址
      └ langstring语言，支持中文和英文。中文用zh-CN；英文用en-US。
      └ valuestring内容，支持中文和英文
    └ registered_office_address_infoaddress注册地址详细信息。公共字段，若请求对象为公司，则该字段必填。
      └ country_region_idstring国家 / 地区 ID。各国家/地区填写字段可参考地址填写规则查询.可通过 查询国家/地区信息查询获取。
      └ region_idstring主要行政区ID.可通过 查询省份/主要行政区信息查询获取。
      └ city_idstring城市ID.可通过 查询城市信息查询获取。
      └ distinct_idstring区/县ID，可通过 查询区/县信息查询获取。
      └ address_line1string地址行 1
      └ address_line2string地址行 2
      └ address_line3string地址行 3
      └ address_line4string地址行 4
      └ address_line5string地址行 5
      └ address_line6string地址行 6
      └ address_line7string地址行 7
      └ address_line8string地址行 8
      └ address_line9string地址行 9
      └ local_address_line1string地址行 1（非拉丁语系的本地文字）
      └ local_address_line2string地址行 2（非拉丁语系的本地文字）
      └ local_address_line3string地址行 3（非拉丁语系的本地文字）
      └ local_address_line4string地址行 4（非拉丁语系的本地文字）
      └ local_address_line5string地址行 5（非拉丁语系的本地文字）
      └ local_address_line6string地址行 6（非拉丁语系的本地文字）
      └ local_address_line7string地址行 7（非拉丁语系的本地文字）
      └ local_address_line8string地址行 8（非拉丁语系的本地文字）
      └ local_address_line9string地址行 9（非拉丁语系的本地文字）
      └ postal_codestring邮政编码
    └ office_address_infoaddress办公地址详细信息。公共字段，若请求对象为公司，则该字段必填。
      └ country_region_idstring国家 / 地区。各国家/地区填写字段可参考地址填写规则查询。
      └ region_idstring主要行政区
      └ city_idstring城市Id.可通过 查询城市信息查询获取。
      └ distinct_idstring区/县ID，可通过 查询区/县信息查询获取。
      └ address_line1string地址行 1
      └ address_line2string地址行 2
      └ address_line3string地址行 3
      └ address_line4string地址行 4
      └ address_line5string地址行 5
      └ address_line6string地址行 6
      └ address_line7string地址行 7
      └ address_line8string地址行 8
      └ address_line9string地址行 9
      └ local_address_line1string地址行 1（非拉丁语系的本地文字）
      └ local_address_line2string地址行 2（非拉丁语系的本地文字）
      └ local_address_line3string地址行 3（非拉丁语系的本地文字）
      └ local_address_line4string地址行 4（非拉丁语系的本地文字）
      └ local_address_line5string地址行 5（非拉丁语系的本地文字）
      └ local_address_line6string地址行 6（非拉丁语系的本地文字）
      └ local_address_line7string地址行 7（非拉丁语系的本地文字）
      └ local_address_line8string地址行 8（非拉丁语系的本地文字）
      └ local_address_line9string地址行 9（非拉丁语系的本地文字）
      └ postal_codestring邮政编码

响应体示例 ​

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "company": {
            "id": "4692472714243080020",
            "hiberarchy_common": {
                "parent_id": "4719168654814483759",
                "name": [
                    {
                        "lang": "zh-CN",
                        "value": "xx有限科技公司"
                    }
                ],
                "type": {
                    "enum_name": "phone_type",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "active": true,
                "effective_time": "2020-05-01 00:00:00",
                "expiration_time": "2020-05-02 00:00:00",
                "code": "12456",
                "description": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ],
                "tree_order": "001000",
                "list_order": "001000-001000",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ]
            },
            "type": {
                "enum_name": "phone_type",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ]
            },
            "industry_list": [
                {
                    "enum_name": "phone_type",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                }
            ],
            "legal_representative": [
                {
                    "lang": "zh-CN",
                    "value": "张三"
                }
            ],
            "post_code": "100000",
            "tax_payer_id": "123456840",
            "confidential": true,
            "sub_type_list": [
                {
                    "enum_name": "phone_type",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                }
            ],
            "branch_company": true,
            "primary_manager": [
                {
                    "lang": "zh-CN",
                    "value": "张三"
                }
            ],
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "Sandy"
                }
            ],
            "currency": {
                "id": "1",
                "country_region_id": "12",
                "currency_name": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ],
                "numeric_code": 12,
                "currency_alpha_3_code": "CNY"
            },
            "phone": {
                "area_code": {
                    "enum_name": "phone_type",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "phone_number": "213213"
            },
            "fax": {
                "area_code": {
                    "enum_name": "phone_type",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "phone_number": "213213"
            },
            "registered_office_address": [
                {
                    "lang": "zh-CN",
                    "value": "张三"
                }
            ],
            "office_address": [
                {
                    "lang": "zh-CN",
                    "value": "张三"
                }
            ],
            "registered_office_address_info": {
                "country_region_id": "6862995757234914824",
                "region_id": "6863326815667095047",
                "city_id": "6863333254578046471",
                "distinct_id": "6863333516579440141",
                "address_line1": "丹佛测试地址-纽埃时区",
                "address_line2": "PoewH",
                "address_line3": "PoewH",
                "address_line4": "jmwJc",
                "address_line5": "jmwJc",
                "address_line6": "jmwJc",
                "address_line7": "jmwJc",
                "address_line8": "rafSu",
                "address_line9": "McPRG",
                "local_address_line1": "丹佛测试地址-纽埃时区",
                "local_address_line2": "PoewH",
                "local_address_line3": "PoewH",
                "local_address_line4": "jmwJc",
                "local_address_line5": "jmwJc",
                "local_address_line6": "jmwJc",
                "local_address_line7": "jmwJc",
                "local_address_line8": "rafSu",
                "local_address_line9": "McPRG",
                "postal_code": "611530"
            },
            "office_address_info": {
                "country_region_id": "6862995757234914824",
                "region_id": "6863326815667095047",
                "city_id": "6863333254578046471",
                "distinct_id": "6863333516579440141",
                "address_line1": "丹佛测试地址-纽埃时区",
                "address_line2": "PoewH",
                "address_line3": "PoewH",
                "address_line4": "jmwJc",
                "address_line5": "jmwJc",
                "address_line6": "jmwJc",
                "address_line7": "jmwJc",
                "address_line8": "rafSu",
                "address_line9": "McPRG",
                "local_address_line1": "丹佛测试地址-纽埃时区",
                "local_address_line2": "PoewH",
                "local_address_line3": "PoewH",
                "local_address_line4": "jmwJc",
                "local_address_line5": "jmwJc",
                "local_address_line6": "jmwJc",
                "local_address_line7": "jmwJc",
                "local_address_line8": "rafSu",
                "local_address_line9": "McPRG",
                "postal_code": "611530"
            }
        }
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
4001160004client_token repeat.请检查 client_token 是否重复
5001160101marshal error检查消息体格式是否符合要求
5001160102unmarshal error请求参数解析失败，请确认请求参数中json数据是否符合参数规范。如果无法解决可以联系飞书人事 技术支持
5001160103request ID repeat请检查请求 ID 是否重复

内容来源：飞书开放平台 · 自动爬取整理

本镜像仅供学习与查阅，文档版权归飞书所有