基本概念介绍

通过基本概念可以了解伙伴云各数据之间层级和关联关系。

企业是伙伴云承载用户和数据的基础结构，API Key 作用于单一企业中，所有的数据操作均会控制在单一企业内，避免跨企业操作带来的数据风险。

company_id 是企业的唯一标记，从企业后台的“企业信息”可以查到。

工作区从属于企业，企业下可以创建多个工作区，一个工作区等同于一个功能相对完整的 SaaS 系统，在工作区内承载具体的数据，同时可为企业用户分配不同的工作区权限，以此在企业内控制用户对数据的权限。

space_id 是工作区的唯一标记，从工作区后台的 URL 地址中可以查到。

工作区内可邀请多个企业成员和非企业成员加入，并为期分配相应的数据权限，往数据中添加成员时只可以添加当前工作区内的成员。

user_id 是工作区成员的唯一标记，不同工作区内同一成员的 user_id 是一样的。

表格从属于工作区，工作区下可以创建多个表格，在表格内存储着具体的数据。

table_id 是表格的唯一标记，从工作区后台的“表格”中点击具体表格，可以在右侧栏的“信息”中查到。

同时在还可以使用工作区内唯一的“别名”（alias）来标记表格，作为调用表格数据的依据，从工作区后台的“表格”中点击具体表格，可以在右侧栏的“设置”中通过“资源别名”进行设置。

字段从属于表格，表格下可以创建多个字段，用来在表格内定义存储数据的结构，字段有多种类型，不同类型的字段存储的数据结构也不相同。

field_id 是字段的唯一标记，从工作区后台的“表格”中点击具体表格，可以在右侧栏的“设置”中通过“资源别名”查到。

同时在还可以使用表格内唯一的“别名”（alias）来标记字段，作为调用字段数据的依据，从工作区后台的“表格”中点击具体表格，可以在右侧栏的“设置”中通过“资源别名”进行设置。

数据从属于表格，表格下可以创建多条数据，根据字段类型的不同，一条数据内存储的字段值的结构也不相同。

item_id 是数据的唯一标记，从工作区前台打开“表格”，点击具体数据，通过弹层查看时从 URL 地址中可以查到。

文件从属于数据，存储于数据中的图片、附件、手写签名类字段中，文件数据会随存储到的数据一同范围，不支持单独获取文件信息。

file_id 是文件的唯一标记。