如何通过Bitrix24 REST API获取详细企业信息并同步本地数据？

核心原因 #

Bitrix24的CRM REST API默认仅返回基础字段集合，地址、自定义字段这类扩展数据不会自动返回，必须显式指定需要获取的字段。

具体解决方案 #

1. 调用接口时指定select参数 #

不管是crm.company.list还是crm.company.get接口，都需要通过select参数列出你需要的所有字段，包括地址相关字段：

• 地址字段示例：ADDRESS（完整地址）、ADDRESS_CITY（城市）、ADDRESS_REGION（地区）、ADDRESS_COUNTRY（国家）、ADDRESS_POSTAL_CODE（邮编）
• 其他需要的字段可按需添加，比如TITLE（企业名称）、PHONE（联系电话）等

示例请求：

• 列表接口：crm.company.list?select[]=ID&select[]=TITLE&select[]=ADDRESS&select[]=ADDRESS_CITY&select[]=ADDRESS_REGION
• 单条详情接口：crm.company.get?id=123&select[]=ID&select[]=TITLE&select[]=ADDRESS&select[]=ADDRESS_COUNTRY

2. 利用CSV中的“信息ID” #

CSV里的“信息ID”就是Bitrix24企业实体的ID字段，是每个企业的唯一标识：

• 同步时可将这个ID作为匹配键，把本地数据与Bitrix24的数据一一对应
• 更新企业数据时，直接通过crm.company.update接口传入该ID和要更新的字段值即可

3. 查询所有可用字段 #

如果不确定哪些字段可以获取，调用crm.company.fields接口，它会返回企业实体的全部字段定义，包括字段名称、类型、是否支持筛选等，帮你确定需要加入select参数的字段。

内容的提问来源于stack exchange，提问作者Eva M.