字段操作

工作表字段的唯一标识是字段名称和工字段ID，可通过表结构查看获取。

添加字段

向已有工作表中添加新字段。

• 目前支持字段类型为:
  • string
  • date
  • number
• uniq_index为主键索引，0不是主键，1为主键；

请求URL：

https://open.bdp.cn/api/field/add

请求方式：GET

请求参数说明：

QueryString：

请求示例：

curl --request GET   --url 'https://open.bdp.cn/api/field/add?access_token=19de5e0297bfd55097733dfbc87ad79e&tb_id=tb_cc8bea1e64fb4794976eafd1d6546512&name=new_field&
type=string&uniq_index=0&title=title_of_field&remark=remark_of_field'

请求成功时返回说明示例：

{
    "status": 0,
    "errstr": "",
    "result": "success"
}

请求失败时返回说明示例：

{
    "status": 6,
    "errstr": "error message"
}

错误代码说明：

查询工作表字段信息

查看工作表的详细结构，可以查看字段ID。

请求URL：

https://open.bdp.cn/api/field/list

请求方式：GET

请求参数说明：

QueryString：

请求示例：

curl --request GET --url 'https://open.bdp.cn/api/field/list?access_token=19de5e0297bfd55097733dfbc87ad79e&tb_id=tb_cc8bea1e64fb4794976eafd1d6546512'

请求成功时返回说明示例：

{
    "status": 0,
    "errstr": "",
    "result": [                         //工作表结构
        {
            "name": "id",                 //字段名称
            "field_id": "fk1713683a",            //字段ID
            "uniq_index": 0,                   //唯一键值标记
            "type": "string"                   //字段类型
        },
        {
            "name": "name",
            "field_id": "fk44d9a111",
            "uniq_index": 0,
            "type": "date"
        },
        {
                "name": "birth",
            "field_id": "fk8967485c",
            "uniq_index": 0,
            "type": "number"
        }
    ]
}

请求失败时返回说明示例：

{
    "status": 0,
    "errstr": ""
}

错误代码说明：

修改工作表字段属性

可以修改字段的类型和索引属性。修改主键索引可能会引起数据变动，结果将根据新主键索引去重，请谨慎使用。

请求URL：

https://open.bdp.cn/api/field/modify

请求方式：GET

请求参数说明：

QueryString：

请求示例：

curl --request GET   --url 'https://open.bdp.cn/api/field/modify?access_token=19de5e0297bfd55097733dfbc87ad79e&tb_id=tb_cc8bea1e64fb4794976eafd1d6546512&
name=new_field&type=string&uniq_index=0&title=title_of_field&remark=remark_of_field'

请求成功时返回说明示例：

{
    "status": 0,
    "errstr": "",
    "result": "success"
}

请求失败时返回说明示例：

{
    "status": 6,
    "errstr": "error message"
}

错误代码说明：

删除工作表字段

强制删除已有工作表中的字段，会导致引用到该字段的图表实效。

请求URL：

https://open.bdp.cn/api/field/delete

请求方式：GET

请求参数说明：

QueryString：

请求示例：

curl --request GET   --url 'https://open.bdp.cn/api/field/modify?access_token=19de5e0297bfd55097733dfbc87ad79e&tb_id=tb_cc8bea1e64fb4794976eafd1d6546512&name=new_field&
type=string&uniq_index=0&title=title_of_field&remark=remark_of_field'

请求成功时返回说明示例：

{
    "status": 0,
    "errstr": "",
    "result": "success"
}

请求失败时返回说明示例：

{
    "status": 6,
    "errstr": "error message"
}

错误代码说明：