更新字段

请求说明

请求地址	https://openapi.wps.cn/v7/coop/dbsheet/{file_id}/sheets/{sheet_id}/fields/update
请求方法	POST
签名方式	KSO-1
权限要求	管理多维表格（用户授权） kso.dbsheet.readwrite

请求头（Header）

Header 名称	参数类型	是否必填	说明
Content-Type	string	是	使用：application/json
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：Bearer {access_token}

路径参数（Path）

名称	参数类型	说明
file_id	string	文件 id
sheet_id	integer	数据表 id

请求体（Body）

名称	参数类型	是否必填	说明
fields	array[object]	是	字段，详见多维表格参数说明
prefer_id	boolean	否	是否使用 id 来标识字段。为 true 时 Lookup 类型 linkField 与 lookupField 需传递字段 id

请求地址示例

[POST] https://openapi.wps.cn/v7/coop/dbsheet/{file_id}/sheets/{sheet_id}/fields/update

请求体示例

{
  "fields": [
    {
      "name": "日期",
      "id": "q",
      "type": "Date",
      "data": {
        "number_format": "yyyy\"年\"m\"月\"d\"日\";@",
        "default_value_type": "Normal",
        "default_value": "2024/11/23"
      }
    }
  ],
  "prefer_id": true
}

响应体

名称	参数类型	说明
code	integer	响应代码。非 0 表示失败，参照《状态码说明》
msg	string	响应信息
data	object	响应数据
∟ fields	array[object]	字段，详见多维表格参数说明
more	object	更多的错误信息

响应体示例

{
  "code": 0,
  "msg": "",
  "data": {
    "fields": [
      {
        "name": "日期",
        "type": "Date",
        "id": "q",
        "data": {
          "default_value": "2024/11/23",
          "default_value_type": "Normal",
          "number_format": "yyyy\"年\"m\"月\"d\"日\";@"
        }
      }
    ]
  }
}