自定义字段（国际化版）

概述

自定义字段 CRUD 接口，支持按模块管理客服系统的自定义字段（工单、联系人、客服等）。

Base URL: /api/v1

Content-Type: application/json

认证方式（二选一）：

Basic Auth — HTTP Basic Auth 头，账号密码登录

Bearer Token — OAuth2 令牌，Header: Authorization: Bearer <token>

权限: 仅管理员可操作（isAdmin）

模块与支持类型

模块一览

module	说明	对应表前缀
`ticket`	工单	`FreeColumnAGent` + 租户 ID
`company`	客户	`companyColumnAgent` + 租户 ID
`contact`	联系人	`contacterColumnAgent` + 租户 ID
`servicer`	客服	`servicerColumnAgent` + 租户 ID
`service_summary`	服务总结	`FreeColumnAGent` + 租户 ID
`asset_table`	表单/资产表	`tableList`（需传 `tableId`）

字段类型一览

type	名称	说明	输入格式
1	下拉列表	单选下拉，带选项列表	`custom_field_options` + `extraConfig`
2	单行文本	短文本输入	`defaultValue`(顶层) + `extraConfig`
3	多行文本	长文本域	`defaultValue`(顶层) + `extraConfig`
4	正整数	正整数输入	`extraConfig`
5	小数	小数输入（可设精度）	`extraConfig`
6	复选框	布尔开关	`extraConfig`
7	正则表达式	格式校验文本	`extraConfig`
8	日期	日期选择器	`extraConfig`
10	验证码	短信验证码	`extraConfig`
11	表单	子表单	`extraConfig`
12	文件上传	附件上传	`extraConfig`（必填 `maxUpload`/`maxFileSize`）
13	评分	星级评分	`extraConfig`
14	高级复选框	多选，带选项列表	`custom_field_options` + `extraConfig`
16	满意度评价	满意度评价	`extraConfig`
17	文本电话	电话输入	`extraConfig`
18	级联	多级联动选择	`custom_field_options`（树形结构）
19	地理位置	地图定位	`extraConfig`
20	资产关联	关联资产	`extraConfig`
21	表格文本	表格文本	`extraConfig`
23	签名	手写签名	`extraConfig`
24	支付	支付	`extraConfig`
25	计算字段	表达式自动计算	`extraConfig`（必填 `expressions`）
26	日期时间	日期+时间选择	`extraConfig`

模块支持类型矩阵

模块 \ 字段	下拉列表	单行文本	多行文本	正整数	小数	复选框	正则表达式	日期	验证码	表单	文件上传	评分	高级复选框	满意度评价	文本电话	级联	地理位置	资产关联	表格文本	签名	支付	计算字段	日期时间
module	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
ticket	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	-	✅	✅	✅	✅
company	✅	✅	✅	✅	✅	✅	✅	✅	-	-	✅	-	✅	-	-	✅	-	-	-	-	-	-	-
contact	✅	✅	✅	✅	✅	✅	✅	✅	-	-	✅	-	✅	-	✅	✅	-	-	-	-	-	-	-
servicer	✅	✅	✅	✅	✅	✅	✅	✅	-	-	✅	-	✅	-	-	✅	-	-	-	-	-	-	-
service_summary	✅	✅	✅	✅	✅	✅	✅	✅	-	-	✅	-	✅	-	-	✅	✅	-	-	-	-	-	✅
asset_table	✅	✅	✅	✅	✅	✅	-	✅	-	-	✅	✅	✅	-	-	✅	-	-	✅	-	-	✅	-

通用说明

认证

Basic Auth 或 Bearer Token，需管理员权限。

响应格式

所有接口返回统一格式：

{
    "code": 0,
    "message": "success",
    "data": {}
}

关键参数说明

参数	类型	说明
`name`	string	字段标题，最长 100 字符
`key`	string	字段唯一标识，小写字母/数字/下划线，最长 45 字符，必须含字母，创建后不可修改
`type`	int	字段类型，创建后不可修改
`description`	string	字段描述
`isRequired`	int	是否必选（`0`=非必选，`1`=必选，默认 `0`）
`isReadonly`	int	是否只读（`0`=可编辑，`1`=只读，默认 `0`）
`isFooter`	int/bool	是否表尾字段（仅 `asset_table` 模块，默认 `false`）
`custom_field_options`	array	选项数据（type 1/14/18 必填）
`extraConfig`	object	额外配置（按类型不同）
`i18n`	object	多语言翻译

API 接口

1. 获取自定义字段列表

GET /custom_fields?module={module}[&tableId={tableId}][&isFooter=1]

获取指定模块所有自定义字段列表。

Query Parameters

参数	类型	必填	说明
`module`	string	是	模块名称
`tableId`	int	`asset_table` 必填	表单 ID
`isFooter`	int	否	仅返回表尾字段

Response 字段说明

字段	类型	说明
`id`	int	字段 ID
`name`	string	字段标题
`key`	string	字段标识
`type`	int	字段类型
`system`	int	是否系统字段（`1`=系统字段，`0`=自定义）
`description`	string	字段描述
`isRequired`	int	是否必选（`1`=必选，`0`=非必选）
`isReadonly`	int	是否只读（`0`=可编辑，`1`=只读）
`readonly_range`	int	只读范围（`1`=所有客服，`2`=客服分组，`3`=客服，`4`=当前用户）
`readonly_support`	string	只读范围对应的客服 ID 或分组 ID
`isFooter`	int	是否表尾字段（仅 `asset_table` 模块）
`tabletype`	int	表单类型（仅 `asset_table` 模块）
`tableId`	int	表单 ID（仅 `asset_table` 模块）
`extra_config`	object	额外配置（按类型不同）
`custom_field_options`	array	选项列表（type 1/14/18）
`i18n`	object	多语言配置

表单类型（tabletype）

tabletype	说明
0	普通
1	普通表单
2	评价表单
3	工单资产表单
4	客户管理资产表单

响应示例

{
    "code": 0,
    "message": "success",
    "data": {
        "custom_fields": [
            {
                "id": 925433,
                "name": "客户名称",
                "key": "customer_name",
                "type": 2,
                "system": 0,
                "description": "客户公司名称",
                "isRequired": 1,
                "isReadonly": 0,
                "tabletype": 0,
                "tableId": 0,
                "isFooter": 0,
                "extra_config": {
                    "defaultValue": "",
                    "placeholder": "请输入客户名称",
                    "maxLength": "200",
                    "popover_tip": "填写完整的公司名称",
                    "showLevel": ""
                },
                "custom_field_options": [],
                "i18n": {
                    "zh_CN": {
                        "name": "客户名称",
                        "popover_tip": "填写完整的公司名称",
                        "default_value": "",
                        "placeholder": "请输入客户名称",
                        "opt_labels": {},
                        "cascade_labels": {}
                    },
                    "en_US": {
                        "name": "Customer Name",
                        "popover_tip": "Enter full company name",
                        "default_value": "",
                        "placeholder": "Enter customer name",
                        "opt_labels": {},
                        "cascade_labels": {}
                    }
                }
            }
        ]
    }
}

curl 示例

认证方式二选一：Basic Auth 用 -u 'username:password'，Bearer Token 用 -H 'Authorization: Bearer <token>'。

2. 创建自定义字段

POST /custom_fields?module={module}[&tableId={tableId}][&isFooter=1]

通用请求参数

字段	类型	必填	说明
`name`	string	是	字段标题，最长 100 字符
`key`	string	是	字段标识，小写字母/数字/下划线，最长 45 字符，必须含字母
`type`	int	是	字段类型，需在模块支持范围内
`description`	string	否	字段描述
`isRequired`	int	否	是否必选（`0`=非必选，`1`=必选，默认 `0`）
`isReadonly`	int	否	`0`=可编辑，`1`=只读（默认 `0`）
`custom_field_options`	array	type 1/14/18 必填	选项或级联数据
`extraConfig`	object	否	额外配置
`i18n`	object	否	多语言翻译
`isFooter`	bool	否	是否表尾字段（仅 `asset_table` 模块）

各类型创建参数详解

type=1 下拉列表

参数	必填	说明
`custom_field_options`	是	选项列表，`[{key, value, externalId?}]`
`extraConfig.defaultValue`	否	默认选中值
`extraConfig.placeholder`	否	占位提示
`extraConfig.popover_tip`	否	浮窗提示
`extraConfig.showLevel`	否	只读范围配置

{
    "name": "客户等级",
    "key": "customer_level",
    "type": 1,
    "description": "客户等级分类",
    "isRequired": 0,
    "custom_field_options": [
        {"key": 1, "value": "普通"},
        {"key": 2, "value": "VIP"},
        {"key": 3, "value": "VVIP"}
    ],
    "extraConfig": {
        "defaultValue": "1",
        "placeholder": "请选择客户等级"
    },
    "i18n": {
        "en_US": {
            "name": "Customer Level",
            "popover_tip": "Select customer tier",
            "placeholder": "Select tier",
            "opt_labels": {"1": "Normal", "2": "VIP", "3": "VVIP"}
        }
    }
}

带外部系统映射 ID：

{
    "name": "ERP 客户分类",
    "key": "erp_category",
    "type": 1,
    "custom_field_options": [
        {"key": 1, "value": "经销商", "externalId": "EXT_001"},
        {"key": 2, "value": "直客", "externalId": "EXT_002"}
    ]
}

type=2 单行文本

参数	必填	说明
`defaultValue`	否	默认值（顶层字段，不在 extraConfig 内）
`extraConfig.maxLength`	否	最大字符数
`extraConfig.placeholder`	否	占位提示
`extraConfig.popover_tip`	否	浮窗提示
`extraConfig.showLevel`	否	只读范围配置

{
    "name": "客户名称",
    "key": "customer_name",
    "type": 2,
    "description": "客户公司全称",
    "isRequired": 0,
    "defaultValue": "默认公司名",
    "extraConfig": {
        "maxLength": "200",
        "placeholder": "请输入客户名称",
        "popover_tip": "填写完整的客户公司名称"
    }
}

type=3 多行文本

参数同 type=2：

{
    "name": "备注信息",
    "key": "remark",
    "type": 3,
    "description": "客户备注信息",
    "isRequired": 1,
    "extraConfig": {
        "maxLength": "500",
        "placeholder": "请输入备注信息",
        "popover_tip": "补充客户相关信息"
    }
}

type=4 正整数

参数	必填	说明
`extraConfig.min`	否	最小值
`extraConfig.max`	否	最大值
`extraConfig.placeholder`	否	占位提示

{
    "name": "客户人数",
    "key": "employee_count",
    "type": 4,
    "description": "企业员工人数",
    "extraConfig": {
        "min": "1",
        "max": "100000",
        "placeholder": "请输入员工人数"
    }
}

type=5 小数

参数	必填	说明
`extraConfig.min`	否	最小值
`extraConfig.max`	否	最大值
`extraConfig.precision`	否	小数精度（小数位数）
`extraConfig.placeholder`	否	占位提示

{
    "name": "成交金额",
    "key": "deal_amount",
    "type": 5,
    "description": "订单成交金额",
    "extraConfig": {
        "min": "0",
        "max": "999999.99",
        "precision": "2",
        "placeholder": "请输入成交金额"
    }
}

type=6 复选框

参数	必填	说明
`extraConfig.defaultValue`	否	默认值（`"1"`=选中，`"0"`=未选）
`extraConfig.placeholder`	否	占位提示

{
    "name": "是否VIP",
    "key": "is_vip",
    "type": 6,
    "description": "是否为VIP客户",
    "extraConfig": {
        "defaultValue": "1"
    }
}

type=7 正则表达式

参数	必填	说明
`extraConfig.pattern`	是	正则表达式
`extraConfig.patternMessage`	否	校验失败提示
`extraConfig.maxLength`	否	最大字符数
`extraConfig.placeholder`	否	占位提示
`extraConfig.popover_tip`	否	浮窗提示

{
    "name": "手机号",
    "key": "phone_number",
    "type": 7,
    "description": "客户手机号",
    "extraConfig": {
        "pattern": "^1[3-9]\\d{9}$",
        "patternMessage": "请输入正确的11位手机号",
        "maxLength": "11",
        "placeholder": "请输入手机号",
        "popover_tip": "仅支持中国大陆手机号"
    }
}

type=8 日期

参数	必填	说明
`extraConfig.format`	否	日期格式（如 `yyyy-MM-dd`）
`extraConfig.minDate`	否	最小可选日期
`extraConfig.maxDate`	否	最大可选日期
`extraConfig.defaultValue`	否	默认值
`extraConfig.placeholder`	否	占位提示

{
    "name": "到期日期",
    "key": "expiry_date",
    "type": 8,
    "description": "合同到期日期",
    "extraConfig": {
        "format": "yyyy-MM-dd",
        "minDate": "2024-01-01",
        "maxDate": "2099-12-31",
        "placeholder": "请选择到期日期"
    }
}

type=12 文件上传

参数	必填	说明
`extraConfig.maxUpload`	是	最大上传文件数（≥1）
`extraConfig.maxFileSize`	是	最大文件大小（MB，≥1）
`extraConfig.popover_tip`	否	浮窗提示

{
    "name": "附件上传",
    "key": "attachment",
    "type": 12,
    "description": "上传相关附件",
    "extraConfig": {
        "maxUpload": 5,
        "maxFileSize": 15,
        "popover_tip": "支持 jpg/png/pdf，单文件不超过 15MB"
    }
}

type=13 评分

{
    "name": "满意度评分",
    "key": "satisfaction_score",
    "type": 13,
    "description": "客户满意度评分"
}

type=14 高级复选框

参数	必填	说明
`custom_field_options`	是	选项列表，`[{key, value, externalId?}]`
`extraConfig.defaultValue`	否	默认选中值
`extraConfig.placeholder`	否	占位提示
`extraConfig.popover_tip`	否	浮窗提示
`extraConfig.showLevel`	否	只读范围配置

{
    "name": "兴趣爱好",
    "key": "hobbies",
    "type": 14,
    "description": "客户兴趣爱好（多选）",
    "isRequired": 1,
    "custom_field_options": [
        {"key": 1, "value": "阅读"},
        {"key": 2, "value": "运动"},
        {"key": 3, "value": "音乐"},
        {"key": 4, "value": "旅行"}
    ],
    "extraConfig": {
        "placeholder": "请选择兴趣爱好"
    }
}

type=17 文本电话

{
    "name": "联系电话",
    "key": "contact_phone",
    "type": 17,
    "description": "客户联系电话"
}

type=18 级联

custom_field_options 为树形嵌套结构，key 可选（不传自动分配 ID）：

{
    "name": "所在地区",
    "key": "region",
    "type": 18,
    "description": "客户所在地区（省市区）",
    "isRequired": 0,
    "custom_field_options": [
        {
            "value": "北京市",
            "subset_value": [
                {
                    "value": "海淀区",
                    "subset_value": [
                        {"value": "中关村"},
                        {"value": "清华大学"}
                    ]
                },
                {"value": "丰台区"},
                {"value": "朝阳区"}
            ]
        },
        {
            "value": "上海市",
            "subset_value": [
                {"value": "浦东新区"},
                {"value": "徐汇区"}
            ]
        },
        {"value": "广东省"}
    ],
    "extraConfig": {
        "popover_tip": "选择省市区"
    },
    "i18n": {
        "en_US": {
            "name": "Region",
            "popover_tip": "Select region",
            "cascade_labels": {"1": "Beijing", "2": "Shanghai"}
        }
    }
}

type=19 地理位置

{
    "name": "服务地址",
    "key": "service_address",
    "type": 19,
    "description": "上门服务地址"
}

type=21 表格文本（仅 asset_table）

{
    "name": "备注列",
    "key": "remark_col",
    "type": 21,
    "description": "表格备注列"
}

type=23 签名

参数	必填	说明
`extraConfig.showLevel`	否	只读范围配置
`extraConfig.placeholder`	否	占位提示
`extraConfig.popover_tip`	否	浮窗提示

{
    "name": "客户签名",
    "key": "customer_signature",
    "type": 23,
    "description": "客户手写签名确认",
    "isRequired": 0,
    "extraConfig": {
        "placeholder": "请在下方签名"
    }
}

type=24 支付

参数	必填	说明
`extraConfig.tableName`	否	关联表名
`extraConfig.alipay`	否	支付宝配置
`extraConfig.showLevel`	否	只读范围配置
`extraConfig.placeholder`	否	占位提示
`extraConfig.popover_tip`	否	浮窗提示

{
    "name": "支付金额",
    "key": "payment_amount",
    "type": 24,
    "description": "在线支付金额",
    "extraConfig": {
        "tableName": "order_table",
        "placeholder": "请输入支付金额"
    }
}

type=25 计算字段

参数	必填	说明
`extraConfig.expressions`	是	计算公式，用 `{{field_key}}` 引用其他字段
`extraConfig.placeholder`	否	占位提示
`extraConfig.popover_tip`	否	浮窗提示

{
    "name": "总价",
    "key": "total_price",
    "type": 25,
    "description": "单价×数量自动计算",
    "extraConfig": {
        "expressions": "{{unit_price}} * {{quantity}}",
        "placeholder": "自动计算总价"
    }
}

type=26 日期时间

参数	必填	说明
`extraConfig.datechose`	否	日期时间模式（`"1"`=日期+时间，默认 `"1"`）
`extraConfig.showLevel`	否	只读范围配置
`extraConfig.placeholder`	否	占位提示
`extraConfig.popover_tip`	否	浮窗提示

{
    "name": "预约时间",
    "key": "appointment_time",
    "type": 26,
    "description": "客户预约服务时间",
    "isRequired": 0,
    "extraConfig": {
        "datechose": "1",
        "placeholder": "请选择预约时间",
        "popover_tip": "选择预约上门服务时间"
    }
}

3. 更新自定义字段

PUT /custom_fields/{id}?module={module}[&tableId={tableId}][&isFooter=1]

约束

约束	说明
`key`	❌ 不可变更
`type`	❌ 不可变更
其他字段	✅ 可选更新，不传的字段保持原有值

请求参数

字段	类型	说明
`name`	string	更新字段标题
`description`	string	更新字段描述
`isRequired`	int	更新是否必选（`0`=非必选，`1`=必选）
`isReadonly`	int	更新是否只读（`0`=可编辑，`1`=只读）
`custom_field_options`	array	更新选项或级联数据（type 1/14/18）
`extraConfig`	object	更新额外配置
`i18n`	object	更新多语言翻译

各类型的 extraConfig 和 custom_field_options 参数同创建接口。

更新示例

响应

同创建接口，返回更新后的完整字段数据。

4. 删除自定义字段

DELETE /custom_fields/{id}?module={module}[&tableId={tableId}]

删除自定义字段，同时清理国际化数据。

示例

响应

{
    "code": 0,
    "message": "success",
    "data": {
        "custom_fields": {
            "message": "Field deleted successfully"
        }
    }
}

extra_config 字段参考

各类型 extra_config 响应字段

type	extra_config 返回字段
1	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `optExternalId`, `optVisibility`, `dropExternalCheckVal`, `maxLength`
2, 3	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxLength`
4	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `min`, `max`, `maxLength`
5	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `min`, `max`, `precision`, `maxLength`
6	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxLength`
7	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `pattern`, `patternMessage`, `maxLength`
8	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `format`, `minDate`, `maxDate`, `maxLength`
12	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxUpload`, `maxFileSize`, `maxLength`
13	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxLength`
14	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `adcheckbox_min`, `adcheckbox_max`, `defaultcheckboxhigthValue`, `optExternalId`, `maxLength`
17	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxLength`
18	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxLength`
19	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxLength`
21	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxLength`
23	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `signatureurl`, `maxLength`
24	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `tableName`, `alipay`, `maxLength`
25	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `expressions`, `maxLength`
26	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `datechose`, `maxLength`
其他	`defaultValue`, `placeholder`, `popover_tip`, `showLevel`, `maxLength`

custom_field_options 格式

type 1 / 14 — 选项列表

[
    {"key": 1, "value": "选项A"},
    {"key": 2, "value": "选项B"},
    {"key": 3, "value": "选项C", "externalId": "EXT_003"}
]

字段	类型	必填	说明
`key`	int	否	选项 ID，传 `0` 由系统自动分配
`value`	string	是	选项名称，最长 130 字符，同一字段内不可重复
`externalId`	string	否	外部系统映射 ID（ERP 等）

type 18 — 级联树形结构

[
    {
        "key": "1",
        "value": "北京市",
        "subset_value": [
            {
                "key": "3",
                "value": "海淀区",
                "subset_value": [
                    {"key": "5", "value": "中关村"},
                    {"key": "6", "value": "清华大学"}
                ]
            }
        ]
    }
]

字段	类型	必填	说明
`key`	string	否	选项 ID，不传由系统自动分配顺序 ID
`value`	string	是	选项名称
`subset_value`	array	否	子级选项，可无限嵌套

多语言（i18n）

各类型支持的可翻译字段

type	`name`	`popover_tip`	`placeholder`	`default_value`	`opt_labels`	`cascade_labels`
1	✓	✓	-	-	✓	-
2	✓	✓	✓	✓	-	-
3	✓	✓	✓	✓	-	-
6	✓	-	-	-	-	-
7	✓	✓	-	-	-	-
8	✓	-	-	-	-	-
12	✓	✓	-	-	-	-
14	✓	✓	-	-	✓	-
18	✓	✓	-	-	-	✓
23	✓	✓	✓	-	-	-
24	✓	✓	✓	-	-	-
25	✓	✓	✓	-	-	-
26	✓	✓	✓	-	-	-
其他	✓	-	-	-	-	-

自动翻译

若不传 i18n 且租户已启用国际化，系统会自动调用 AI 翻译补充其他语言内容。

i18n 请求示例

{
    "i18n": {
        "en_US": {
            "name": "Customer Level",
            "popover_tip": "Select customer tier",
            "placeholder": "Select tier",
            "default_value": "Normal",
            "opt_labels": {"1": "Normal", "2": "VIP", "3": "Premium"},
            "cascade_labels": {"1": "Beijing", "2": "Shanghai"}
        }
    }
}

错误码

code	message	说明
0	success	成功
100047	Missing module parameter	缺少 `module` 参数
100047	Invalid module: xxx	无效的模块名称
100047	Unsupported module: xxx	不支持的模块
100047	Table not found: xxx	表单不存在（`asset_table`）
100047	Field table not found for module: xxx	字段表不存在
100047	Failed to create field	创建字段失败
110100	No administrator privileges	非管理员无权操作
200001	Missing required fields: name, key, type	缺少必填字段
200001	name and key cannot be empty	name/key 不能为空
200001	name max 100 characters	name 超过 100 字符
200001	key max 45 characters	key 超过 45 字符
200001	key cannot be modified	key 不可修改（PUT）
200001	type cannot be modified	type 不可修改（PUT）
200001	custom_field_options[X].value cannot be empty	选项值不能为空
200001	custom_field_options[X].value length must be 1-130	选项值长度不合法
200001	option values cannot duplicate	选项值不能重复
200001	extraConfig.maxUpload is required for type 12	文件上传必须指定 maxUpload
200001	extraConfig.maxFileSize is required for type 12	文件上传必须指定 maxFileSize
200001	extraConfig.expressions is required for type 25	计算字段必须指定 expressions
200001	adcheckbox_min cannot exceed adcheckbox_max	最少可选数不能超过最多可选数
200002	Unsupported field type: X	该模块不支持此字段类型
200003	key can only contain letters, numbers and underscores	key 格式错误
200003	key must contain at least one letter	key 必须含字母
200004	Field not found	字段不存在
200005	key already exists: xxx	key 已存在
200005	name already exists: xxx	name 已存在

完整 curl 示例集

以下示例使用 Basic Auth 方式。若使用 Bearer Token，将 -u 'username:password' 替换为 -H 'Authorization: Bearer <token>' 即可。

4.4 自定义字段配置

自定义字段 （国际化版）#

概述#

模块与支持类型#

模块一览#

字段类型一览#

模块支持类型矩阵#

通用说明#

认证#

响应格式#

关键参数说明#

API 接口#

1. 获取自定义字段列表#

Query Parameters#

Response 字段说明#

表单类型（tabletype）#

响应示例#

curl 示例#

2. 创建自定义字段#

通用请求参数#

各类型创建参数详解#

type=1 下拉列表#

type=2 单行文本#

type=3 多行文本#

type=4 正整数#

type=5 小数#

type=6 复选框#

type=7 正则表达式#

type=8 日期#

type=12 文件上传#

type=13 评分#

type=14 高级复选框#

type=17 文本电话#

type=18 级联#

type=19 地理位置#

type=21 表格文本（仅 asset_table）#

type=23 签名#

type=24 支付#

type=25 计算字段#

type=26 日期时间#

3. 更新自定义字段#

约束#

请求参数#

更新示例#

响应#

4. 删除自定义字段#

示例#

响应#

extra_config 字段参考#

各类型 extra_config 响应字段#

custom_field_options 格式#

type 1 / 14 — 选项列表#

type 18 — 级联树形结构#

多语言（i18n）#

各类型支持的可翻译字段#

自动翻译#

i18n 请求示例#

错误码#

完整 curl 示例集#

获取列表#

创建字段#

更新字段#

删除字段#