服务端 API/云文档/电子表格/筛选视图/创建筛选视图 # 创建筛选视图 根据传入的参数创建一个筛选视图。Id 和 名字可选，不填的话会默认生成；range 必填。Id 长度为10，由 0-9、a-z、A-Z 组合生成。名字长度不超过100。单个子表内的筛选视图个数不超过 150。 **注意事项**：筛选范围的设置参考：[筛选视图的筛选条件指南](https://open.larksuite.com/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/filter-view-condition-user-guide) ## 请求 基本 |   ---|--- HTTP URL | https://open.larksuite.com/open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views HTTP Method | POST 支持的应用类型 | Custom App、Store App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用**
开启任一权限即可 | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
或
`user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM) Content-Type | string | 是 | **固定值**："application/json; charset=utf-8" ### 路径参数 名称 | 类型 | 描述 ---|---|--- spreadsheet_token | string | 表格 token
**示例值**："shtcnmBA*****yGehy8" sheet_id | string | 子表 id
**示例值**："0b**12" ### 请求体 名称 | 类型 | 必填 | 描述 ---|---|---|--- filter_view_id | string | 否 | 筛选视图 id
**示例值**："pH9hbVcCXA" filter_view_name | string | 否 | 筛选视图名字
**示例值**："筛选视图 1" range | string | 否 | 筛选视图的筛选范围
**示例值**："0b**12!C1:H14" ### 请求体示例 ```json { "filter_view_id": "pH9hbVcCXA", "filter_view_name": "筛选视图 1", "range": "0b**12!C1:H14" } ``` ``` curl --location --request POST 'https://open.larksuite.com/open-apis/sheets/v3/spreadsheets/shtcnspY6YDVPxWjhG09Qxxxxxx/sheets/phwh0X/filter_views' \ --header 'Authorization: Bearer t-2602ac1d050a2a308ab8a98639d25cbaaaf26c9f' \ --header 'Content-Type: application/json' \ --data-raw '{ "range": "phwh0X!C1:H14" }' ``` ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \- filter_view | filter_view | 创建的筛选视图的 id 、name、range filter_view_id | string | 筛选视图 id filter_view_name | string | 筛选视图名字 range | string | 筛选视图的筛选范围 ### 响应体示例 ```json { "code": 0, "msg": "success", "data": { "filter_view": { "filter_view_id": "pH9hbVcCXA", "filter_view_name": "筛选视图 1", "range": "0b**12!C1:H14" } } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 500 | 1315201 | Server Error | 服务内部错误，详询客服 500 | 1315203 | Server Error | 服务内部错误，详询客服 400 | 1310217 | Too Many Request | 检查请求是否发送过于频繁 400 | 1310235 | Retry Later | 稍后重试 400 | 1310214 | SpreadSheet Not Found | 检查表格 token 400 | 1310215 | Sheet Id Not Found | 检查 sheet_id 400 | 1310223 | Col Id Not Found | 列 id 没有找到，可能是错误填写、或者超过表格的列范围 400 | 1310213 | Permission Fail | 没有文档相应权限 400 | 1310204 | Wrong Request Body | 检查请求体参数 400 | 1310229 | Wrong URL Param | 检查 url 参数 400 | 1310202 | Wrong Range | 区域范围错误 400 | 1310226 | Excess Limit | 超出限制，参考响应体中的错误提示 400 | 1310211 | Wrong Sheet Id | 检查 sheet_id 400 | 1310232 | Wrong Style | 样式错误，包括颜色、字体等 400 | 1310218 | Locked Cell | 检查操作的是否为保护范围 400 | 1310237 | Wrong Filter View Id | 错误的筛选视图 id 400 | 1310238 | Exist Filter View Id | 筛选视图 id 已存在 400 | 1310239 | Wrong Filter View Name | 筛选视图名字错误 400 | 1310240 | Exist Filter View Name | 筛选视图名字已存在 400 | 1310241 | Filter View Excess | 筛选视图个数超过上限 400 | 1310242 | In Mix state | Retey Later 400 | 1310249 | Spreadsheet Deleted | 恢复表格后重试