8. 附录：字段类型列表（api-field-types）
下表是现存的所有维格列类型，在使用API的过程中，可对照下表进行数据类型的查询和学习。
| 维格列类型 | 数据类型 | 描述 | ||
|---|---|---|---|---|
| 单行文本 | string | 单行文本，适合保存不带换行符的文本，例如文章的标题。 | ||
| 多行文本 | string | 多行文本，可用于存放较长的文本内容，例如一篇学术论文。 | ||
| 单选 | string | 返回已选择的一个选项值（字符串）。 注①：当创建/更新记录时，提交的选项值并不存在于选项列表，则会返回错误码400，提示“参数错误”。 |
||
| 多选 | array of strings | 返回已选上的若干个选项值构成的字符串数组。 注①：当创建/更新记录时，提交的选项值并不存在于选项列表，则会返回错误码400，提示“参数错误”。 |
||
| 神奇关联 | array of record IDs (strings) | 由多条已关联记录的ID组成的数组。 | ||
| 神奇引用 | any | A表与B表通过神奇关联字段进行表关联后，可使用此字段对B表的任意字段进行引用。 视乎引用的字段类型和方式不同，而返回不同数据类型的运算值。 如果引用方式选择了「原样引用」，则运算结果的数据类型保持与B表源字段一致。 其他引用方式皆返回数字类型的运算值。 |
||
| 智能公式 | number \ | string \ | boolean | 经过公式和函数运算后的结果。 数据类型可能是数字、字符串、布尔值 此字段是运算值。 注①：创建/更新记录时不支持写入。 |
| 数字 | number | 数值，支持负值 通过api调用返回的值，不受列配置里指定的精度影响，只会原样返回。 | ||
| 货币 | number | 数值，支持负值 通过api调用返回的值，不受列配置里指定的精度影响，只会原样返回。 | ||
| 百分比 | number | 数值，支持负值 通过API调用返回的值，不受列配置里指定的精度影响，只会原样返回。 | ||
| 日期 | number \ | sring | 日期和时间，以毫秒（ms）为单位返回时间戳 | |
| 附件 | array of attachment objects | 由若干 “附件对象” 组成的数组。 每一个附件对象应该包含下列属性（部分属性只有特殊媒体类型下存在）： mimeType (string) : 附件的媒体类型 name (string) : 附件的名称 size (number) : 附件的大小，单位为字节 width (number) : 如果附件是图片格式，表示图片的宽度，单位为px height (number) : 如果附件是图片格式，表示图片的高度，单位为px token (string) : 附件的网络访问地址（相对路径） preview (string) : 如果附件是PDF格式，将会生成一个预览图，用户可以通过此网址访问 url (string)：附件的网络访问地址 |
||
| 成员 | array of unit object | 由若干「组织单元（unit）」组成的数组 。 「组织单元」是维格表中描述 “空间站” 与 “成员” 之间的关系的一个抽象概念。 成员（member）、小组（team）都是一种组织单元。 unitId (string) : 组织单元的ID unitType (number) : 组织单元的类型，1是小组，3是成员 unitName (string) : 组织单元的名称，unitType 是 1 为小组名称； unitType 是 3 为成员站内昵称 |
||
| 勾选 | boolean | 布尔类型的 true 或 空 。当此字段被勾选时返回 true 。除此以外，记录中不返回此字段！ |
||
| 评分 | number | 评分值是1-9之间的一个正整数。 如果单元格为空或者撤销评分，则记录中不返回此字段！ |
||
| 网址 | string | URL地址（字符串） | ||
| 电话 | string | 电话号码（字符串） | ||
| 邮箱 | string | 邮箱地址（字符串） | ||
| 创建人 | array of user object | 创建此记录的用户，以数组形式返回。 uuid(string) : 维格表平台下的用户唯一ID name(string) : 优先显示站内昵称，如果没有单独设置站内昵称，则返回用户昵称 avatar(string)：用户头像 注①：此字段不支持编辑。 |
||
| 修改人 | array of user object | 最近一次编辑记录/字段的用户，以数组形式返回 。 uuid(string) : 维格表平台下的用户唯一ID name(string) : 优先显示站内昵称，如果没有单独设置站内昵称，则返回用户昵称 avatar(string)：用户头像 注①：此字段不支持编辑。 |
||
| 创建时间 | number \ | sring | 日期和时间，以毫秒(ms)为单位返回时间戳 | |
| 修改时间 | number \ | sring | 日期和时间，以毫秒(ms)为单位返回时间戳 | |
| 自增数字 | number | 数值，正整数 创建记录时自动生成。 注①：此字段不支持编辑。 |