字段类型说明

创建或更新记录时, 请根据字段类型, 按照以下格式组装数据。

字段类型 类型名称 字段值格式 说明
field_type_single_line 单行文本 "测试_single_line" 文本类字段, 长度不能超过限制.
field_type_text_long 长文本 "测试_text_long" 文本类字段, 长度不能超过限制.
field_type_rich_text 富文本 "测试_rich_text" 文本类字段, 长度不能超过限制.
field_type_multi_line 多行文本 "测试_multi_line" 文本类字段, 长度不能超过限制.
field_type_date 日期 "2020-01-01" "yyyy-MM-dd"
field_type_date_time 时间 "2020-01-01 12:12:12" "yyyy-MM-dd HH:mm:ss ", 精确到秒.
field_type_numeric 数字 "1"
field_type_telephone 电话 "13300000001,13300000002" 多个号码使用逗号分隔.

号码必须合法,
1. 手机号: "1[3456789]"开头
2. 电话号: 不能包含横杠
3. 400热线
4. 运营商热线: 10086, 10010, 10000
field_type_email 电子邮件 "admin1@test.cn,admin2@test.cn" 多个邮箱地址使用逗号分隔.
邮箱地址必须合法
field_type_single_listbox 单选列表 "选项名称1"
field_type_multi_listbox 多选列表 "选项名称1,选项名称2" 多个选项使用逗号分隔.
field_type_auto_number 自动编号 自动编号字段不支持接口变更.
field_type_formular 计算公式 计算公式字段不支持接口变更.
field_type_lookup 查找型 "000001"
"13300000001"
"admin1@test.cn"
查找对象唯一字段的值, 需要配合foreignExternalFieldApiName一起使用.
field_type_staff 查找员工 "admin3@test.cn" 员工邮箱地址.
field_type_percent 百分比 "0.3" 原始值, 如30%, 传0.3即可.
field_type_owner 所有人 所有人字段不支持接口变更.
field_type_work_time 工作时间 "测试工作时间01"
field_type_geography 坐标 "116.1884784900,39.9902888700" 经度在前, 纬度在后, 中间使用逗号分隔.
field_type_wechat 微信 "公众号id,OpenId", 逗号分隔.
field_type_sign 签名 签名字段不支持接口变更.
field_type_voice 语音 语音字段不支持接口变更.
field_type_lead_pool 公海 "测试公海01"
field_type_statistics 统计 统计字段不支持接口变更.
field_type_timer 计时 计时字段不支持接口变更.

查询字段列表

GET /v1/fields

请求参数
参数 类型 必填 说明
objectApiName 字符串 对象API_NAME.
响应数据
属性名 类型 说明
code 整型 响应编码.
message 字符串 响应消息.
visible 布尔型 是否可见, true / false .
data 数组 业务对象.
data[].id 整型 字段ID.
data[].label 字符串 显示名称.
data[].apiName 字符串 API名称.
data[].fieldTypeName 字符串 字段类型.
data[].permissionCode 整型 字段权限码:1隐藏;2只读;3必填;4选填.
请求示例
$ curl 'https://servicego.udesk.cn/api/v1/fields?email=admin@udesk.cn&timestamp=1496631984&sign=ef506d04ef74e1031f91025494244e88f3559b78&objectApiName=contact' -i -H 'Content-Type: application/json' -H 'Accept: application/json'
响应示例
{
  "code" : 200,
  "message" : "OK",
  "visible" : false,
  "data" : [ {
    "id" : 7,
    "label" : "姓名",
    "apiName" : "name",
    "fieldTypeName" : "单行文本",
    "permissionCode" : 3
  }, {
    "id" : 13,
    "label" : "邮箱",
    "apiName" : "mailAddress",
    "fieldTypeName" : "电子邮件",
    "permissionCode" : 4
  }, {
    "id" : 14,
    "label" : "电话",
    "apiName" : "phone",
    "fieldTypeName" : "电话",
    "permissionCode" : 4
  } ]
}