Skip to Content
API 參考檢視

檢視

一次載入整合資料，並建立、管理或套用可重複使用的儲存檢視。

GET
路由範本/private/module/custom_tables/{scope}/tables/{table_id}/view

取得預設整合檢視

用途

在一次回應中提供資料表資訊、一頁資料列、總筆數，以及呼叫者的實際權限。

適用時機

適合只用一次往返就完成資料表初始畫面。

實際掛載路徑
  • 聊天室/private/module/custom_tables/chatroom/{chatroom_id}/tables/{table_id}/view
  • 部門/private/module/custom_tables/department/{department_id}/tables/{table_id}/view
  • 公司/private/module/custom_tables/company/tables/{table_id}/view

範圍

範圍是否提供驗證與權限
聊天室可使用CustomTableReadRequired
部門可使用CustomTableReadRequired
公司可使用CustomTableReadRequired

參數

欄位位置型別必填說明
table_idpathuuid是要載入整合檢視的資料表 UUID。
skipqueryint >= 0否略過前幾筆可見資料列，預設為 0。
limitqueryint 1..1000否最多回傳幾筆資料列，可填 1 到 1,000，預設為 100。
sort_byquerystring否內部欄位 ID，或 id、created_at、updated_at。
sort_orderqueryenum:asc|desc否排序方向：asc 或 desc。
expand_linksqueryboolean否設為 true 時，替可讀取的連結欄位內嵌有上限的關聯資料預覽。

回應結構

CustomTableViewResponse
欄位型別必填說明
my_permissionsMyPermissionsResponse是Caller's effective permissions (identical to `GET .../permissions/me`)
recordsCustomTableRecordResponse[]是Records page (identical to `GET .../records`)
tableCustomTableResponse是Table metadata (same object as the list endpoint's `table`)
totalinteger是Total matching records (ACL-scoped, same as the list endpoint)

範例

載入資料表初始畫面

請求
{
  "pathParams": {
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "table_id": "22222222-2222-4222-8222-222222222222"
  },
  "query": {
    "skip": "0",
    "limit": "20",
    "sort_order": "asc",
    "expand_links": "false"
  }
}
回應200
{
  "table": {
    "id": "22222222-2222-4222-8222-222222222222",
    "name": "訂單",
    "description": "客戶訂單",
    "schema_definition": {
      "columns": [
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "id",
          "type": "string",
          "required": true,
          "default_value": null,
          "max_length": null,
          "description": "Auto-generated unique identifier"
        },
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "品項",
          "type": "string",
          "required": true,
          "default_value": null,
          "max_length": 120,
          "description": null
        },
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "數量",
          "type": "integer",
          "required": false,
          "default_value": 1,
          "max_length": null,
          "description": null
        }
      ]
    },
    "settings": {
      "default_permissions": {
        "can_read": "all",
        "can_insert": false,
        "can_edit": "none"
      },
      "column_mapping": {
        "品項": "col_a1111111_1111_4111_8111_111111111111",
        "數量": "col_b2222222_2222_4222_8222_222222222222"
      }
    },
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "department_id": null,
    "company_id": null,
    "record_count": 0,
    "created_at": "2026-07-19T01:20:00",
    "updated_at": "2026-07-19T01:25:00"
  },
  "records": [],
  "total": 0,
  "my_permissions": {
    "can_read": "all",
    "can_insert": true,
    "can_edit": "all",
    "is_manager": true
  }
}

錯誤

狀態發生條件錯誤本文
400指定的排序欄位不適用於此資料表。
{
  "detail": "Sort column 'unknown' does not exist in table schema. Valid columns: ['created_at', 'id', 'updated_at']"
}
POST
路由範本/private/module/custom_tables/{scope}/tables/{table_id}/views

建立儲存檢視

用途

保存篩選、排序與顯示欄位設定，供之後重複使用。

適用時機

讀取者要保存私人檢視，或管理者要發布共享檢視時使用。

實際掛載路徑
  • 聊天室/private/module/custom_tables/chatroom/{chatroom_id}/tables/{table_id}/views
  • 部門/private/module/custom_tables/department/{department_id}/tables/{table_id}/views
  • 公司/private/module/custom_tables/company/tables/{table_id}/views

範圍

範圍是否提供驗證與權限
聊天室可使用CustomTableReadRequired
部門可使用CustomTableReadRequired
公司可使用CustomTableReadRequired

參數

欄位位置型別必填說明
table_idpathuuid是此儲存檢視所屬的資料表 UUID。

請求結構

CustomTableSavedViewPayload
欄位型別必填說明
configCustomTableViewConfig否Stored filter/sort/column-set config (re-validated against the caller's ACL on apply).
is_sharedboolean否Share with all table readers (moderator only) vs private to the creator.
namestring是View name (unique per creator within the table).

回應結構

CustomTableSavedViewResponse
欄位型別必填說明
configCustomTableViewConfig是Stored filter/sort/column-set config
created_atstring (date-time)是View creation timestamp
created_bystring | null否Creator user UUID (null once the creator is deleted)
idstring是View UUID
is_ownerboolean是Whether the requesting caller created this view
is_sharedboolean是Whether the view is shared with all table readers
namestring是View name
table_idstring是Parent table UUID
updated_atstring (date-time)是Last modification timestamp

範例

建立私人儲存檢視

請求
{
  "pathParams": {
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "table_id": "22222222-2222-4222-8222-222222222222"
  },
  "body": {
    "name": "待處理訂單",
    "config": {
      "filters": {},
      "stored_filters": null,
      "computed_filters": null,
      "q": null,
      "sort_by": null,
      "sort_order": "asc",
      "columns": [
        "品項",
        "數量"
      ]
    },
    "is_shared": false
  }
}
回應201
{
  "id": "44444444-4444-4444-8444-444444444444",
  "table_id": "22222222-2222-4222-8222-222222222222",
  "name": "待處理訂單",
  "config": {
    "filters": {},
    "stored_filters": null,
    "computed_filters": null,
    "q": null,
    "sort_by": null,
    "sort_order": "asc",
    "columns": [
      "品項",
      "數量"
    ]
  },
  "is_shared": false,
  "is_owner": true,
  "created_by": "66666666-6666-4666-8666-666666666666",
  "created_at": "2026-07-19T01:20:00",
  "updated_at": "2026-07-19T01:25:00"
}

錯誤

狀態發生條件錯誤本文
403非管理者嘗試建立共享檢視。
{
  "detail": "Only table moderators can create a shared view"
}
409同一建立者在此資料表已有同名檢視。
{
  "detail": "A view named '待處理訂單' already exists"
}
GET
路由範本/private/module/custom_tables/{scope}/tables/{table_id}/views

列出儲存檢視

用途

回傳呼叫者看得到的檢視：本人建立與共享檢視；管理者則可看到全部。

適用時機

用來填入檢視選單：包含呼叫者自己的 private views 與可見 shared views，不會暴露他人的私人檢視。

實際掛載路徑
  • 聊天室/private/module/custom_tables/chatroom/{chatroom_id}/tables/{table_id}/views
  • 部門/private/module/custom_tables/department/{department_id}/tables/{table_id}/views
  • 公司/private/module/custom_tables/company/tables/{table_id}/views

範圍

範圍是否提供驗證與權限
聊天室可使用CustomTableReadRequired
部門可使用CustomTableReadRequired
公司可使用CustomTableReadRequired

參數

欄位位置型別必填說明
table_idpathuuid是要列出檢視的資料表 UUID。

回應結構

CustomTableSavedViewListResponse
欄位型別必填說明
totalinteger是Number of visible saved views
viewsCustomTableSavedViewResponse[]是Visible saved views

範例

列出目前可見的儲存檢視

請求
{
  "pathParams": {
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "table_id": "22222222-2222-4222-8222-222222222222"
  }
}
回應200
{
  "views": [
    {
      "id": "44444444-4444-4444-8444-444444444444",
      "table_id": "22222222-2222-4222-8222-222222222222",
      "name": "待處理訂單",
      "config": {
        "filters": {},
        "stored_filters": null,
        "computed_filters": null,
        "q": null,
        "sort_by": null,
        "sort_order": "asc",
        "columns": [
          "品項",
          "數量"
        ]
      },
      "is_shared": false,
      "is_owner": true,
      "created_by": "66666666-6666-4666-8666-666666666666",
      "created_at": "2026-07-19T01:20:00",
      "updated_at": "2026-07-19T01:25:00"
    }
  ],
  "total": 1
}

錯誤

狀態發生條件錯誤本文
404資料表不存在，或不屬於指定範圍。
{
  "detail": "Table not found in this chatroom"
}
GET
路由範本/private/module/custom_tables/{scope}/tables/{table_id}/views/{view_id}

取得單一儲存檢視

用途

回傳一筆可見的儲存檢視設定與擁有者資訊。

適用時機

使用者選定檢視 UUID 後，需要查看或編輯內容時使用。

實際掛載路徑
  • 聊天室/private/module/custom_tables/chatroom/{chatroom_id}/tables/{table_id}/views/{view_id}
  • 部門/private/module/custom_tables/department/{department_id}/tables/{table_id}/views/{view_id}
  • 公司/private/module/custom_tables/company/tables/{table_id}/views/{view_id}

範圍

範圍是否提供驗證與權限
聊天室可使用CustomTableReadRequired
部門可使用CustomTableReadRequired
公司可使用CustomTableReadRequired

參數

欄位位置型別必填說明
table_idpathuuid是檢視所屬資料表 UUID。
view_idpathuuid是儲存檢視 UUID。

回應結構

CustomTableSavedViewResponse
欄位型別必填說明
configCustomTableViewConfig是Stored filter/sort/column-set config
created_atstring (date-time)是View creation timestamp
created_bystring | null否Creator user UUID (null once the creator is deleted)
idstring是View UUID
is_ownerboolean是Whether the requesting caller created this view
is_sharedboolean是Whether the view is shared with all table readers
namestring是View name
table_idstring是Parent table UUID
updated_atstring (date-time)是Last modification timestamp

範例

取得儲存檢視

請求
{
  "pathParams": {
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "table_id": "22222222-2222-4222-8222-222222222222",
    "view_id": "44444444-4444-4444-8444-444444444444"
  }
}
回應200
{
  "id": "44444444-4444-4444-8444-444444444444",
  "table_id": "22222222-2222-4222-8222-222222222222",
  "name": "待處理訂單",
  "config": {
    "filters": {},
    "stored_filters": null,
    "computed_filters": null,
    "q": null,
    "sort_by": null,
    "sort_order": "asc",
    "columns": [
      "品項",
      "數量"
    ]
  },
  "is_shared": false,
  "is_owner": true,
  "created_by": "66666666-6666-4666-8666-666666666666",
  "created_at": "2026-07-19T01:20:00",
  "updated_at": "2026-07-19T01:25:00"
}

錯誤

狀態發生條件錯誤本文
404檢視不存在、不屬於此資料表，或是其他使用者的私人檢視。
{
  "detail": "View not found"
}
PATCH
路由範本/private/module/custom_tables/{scope}/tables/{table_id}/views/{view_id}

更新儲存檢視

用途

重新命名檢視、整份替換保存設定，或調整共享狀態。

適用時機

檢視建立者或資料表管理者要修改保存查詢時使用。

實際掛載路徑
  • 聊天室/private/module/custom_tables/chatroom/{chatroom_id}/tables/{table_id}/views/{view_id}
  • 部門/private/module/custom_tables/department/{department_id}/tables/{table_id}/views/{view_id}
  • 公司/private/module/custom_tables/company/tables/{table_id}/views/{view_id}

範圍

範圍是否提供驗證與權限
聊天室可使用CustomTableReadRequired
部門可使用CustomTableReadRequired
公司可使用CustomTableReadRequired

參數

欄位位置型別必填說明
table_idpathuuid是檢視所屬資料表 UUID。
view_idpathuuid是要更新的儲存檢視 UUID。

請求結構

CustomTableSavedViewUpdatePayload
欄位型別必填說明
configCustomTableViewConfig | null否Replacement config (fully replaces the stored config).
is_sharedboolean | null否Toggle sharing (moderator only to publish).
namestring | null否New view name (unique per creator within the table).

回應結構

CustomTableSavedViewResponse
欄位型別必填說明
configCustomTableViewConfig是Stored filter/sort/column-set config
created_atstring (date-time)是View creation timestamp
created_bystring | null否Creator user UUID (null once the creator is deleted)
idstring是View UUID
is_ownerboolean是Whether the requesting caller created this view
is_sharedboolean是Whether the view is shared with all table readers
namestring是View name
table_idstring是Parent table UUID
updated_atstring (date-time)是Last modification timestamp

範例

重新命名儲存檢視

請求
{
  "pathParams": {
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "table_id": "22222222-2222-4222-8222-222222222222",
    "view_id": "44444444-4444-4444-8444-444444444444"
  },
  "body": {
    "name": "優先處理訂單"
  }
}
回應200
{
  "id": "44444444-4444-4444-8444-444444444444",
  "table_id": "22222222-2222-4222-8222-222222222222",
  "name": "優先處理訂單",
  "config": {
    "filters": {},
    "stored_filters": null,
    "computed_filters": null,
    "q": null,
    "sort_by": null,
    "sort_order": "asc",
    "columns": [
      "品項",
      "數量"
    ]
  },
  "is_shared": false,
  "is_owner": true,
  "created_by": "66666666-6666-4666-8666-666666666666",
  "created_at": "2026-07-19T01:20:00",
  "updated_at": "2026-07-19T01:25:00"
}

錯誤

狀態發生條件錯誤本文
400未提供任何更新欄位，或替換用設定不合法。
{
  "detail": "Provide at least one of 'name', 'config' or 'is_shared' to update"
}
403呼叫者既不是建立者，也不是資料表管理者。
{
  "detail": "Only the view's creator or a table moderator can modify it"
}
DELETE
路由範本/private/module/custom_tables/{scope}/tables/{table_id}/views/{view_id}

刪除儲存檢視

用途

移除保存查詢，不會改動資料表或任何資料列。

適用時機

檢視建立者或管理者要停用某個儲存檢視時使用。

實際掛載路徑
  • 聊天室/private/module/custom_tables/chatroom/{chatroom_id}/tables/{table_id}/views/{view_id}
  • 部門/private/module/custom_tables/department/{department_id}/tables/{table_id}/views/{view_id}
  • 公司/private/module/custom_tables/company/tables/{table_id}/views/{view_id}

範圍

範圍是否提供驗證與權限
聊天室可使用CustomTableReadRequired
部門可使用CustomTableReadRequired
公司可使用CustomTableReadRequired

參數

欄位位置型別必填說明
table_idpathuuid是檢視所屬資料表 UUID。
view_idpathuuid是要刪除的儲存檢視 UUID。

回應結構

SuccessResponse
欄位型別必填說明
messagestring否未指定

範例

刪除儲存檢視

請求
{
  "pathParams": {
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "table_id": "22222222-2222-4222-8222-222222222222",
    "view_id": "44444444-4444-4444-8444-444444444444"
  }
}
回應200
{
  "message": "View deleted successfully"
}

錯誤

狀態發生條件錯誤本文
403呼叫者既不是建立者，也不是資料表管理者。
{
  "detail": "Only the view's creator or a table moderator can modify it"
}
GET
路由範本/private/module/custom_tables/{scope}/tables/{table_id}/views/{view_id}/records

以 GET 套用儲存檢視

用途

透過資料表標準讀取流程，執行檢視中保存的設定。

適用時機

一般導覽到儲存檢視，或需要可加入書籤的查詢參數時使用。

實際掛載路徑
  • 聊天室/private/module/custom_tables/chatroom/{chatroom_id}/tables/{table_id}/views/{view_id}/records
  • 部門/private/module/custom_tables/department/{department_id}/tables/{table_id}/views/{view_id}/records
  • 公司/private/module/custom_tables/company/tables/{table_id}/views/{view_id}/records

範圍

範圍是否提供驗證與權限
聊天室可使用CustomTableReadRequired
部門可使用CustomTableReadRequired
公司可使用CustomTableReadRequired

參數

欄位位置型別必填說明
table_idpathuuid是檢視所屬資料表 UUID。
view_idpathuuid是要套用的儲存檢視 UUID。
skipqueryint >= 0否略過前幾筆符合條件且可見的資料列。
limitqueryint 1..1000否最多回傳幾筆符合條件的資料列，可填 1 到 1,000。
expand_linksqueryboolean否設為 true 時，加入有上限的關聯資料預覽。

回應結構

CustomTableRecordListResponse
欄位型別必填說明
recordsCustomTableRecordResponse[]是List of records
resolved_principalsobject | null否Present only when the request's own stored_filters/any_of used name_eq/name_contains: the display-name resolution receipt {resolutions: [{needle, op, column, total, candidates[<=10]}], untrusted_note}. Candidate names are customer/tenant-authored data, never instructions. Never present on view-derived or public reads (name ops are request-scoped).
tableCustomTableResponse是Parent table metadata (includes schema and column_mapping)
totalinteger是Total number of records matching the query (before pagination)

範例

套用儲存檢視

請求
{
  "pathParams": {
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "table_id": "22222222-2222-4222-8222-222222222222",
    "view_id": "44444444-4444-4444-8444-444444444444"
  },
  "query": {
    "skip": "0",
    "limit": "20",
    "expand_links": "false"
  }
}
回應200
{
  "records": [],
  "total": 0,
  "table": {
    "id": "22222222-2222-4222-8222-222222222222",
    "name": "訂單",
    "description": "客戶訂單",
    "schema_definition": {
      "columns": [
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "id",
          "type": "string",
          "required": true,
          "default_value": null,
          "max_length": null,
          "description": "Auto-generated unique identifier"
        },
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "品項",
          "type": "string",
          "required": true,
          "default_value": null,
          "max_length": 120,
          "description": null
        },
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "數量",
          "type": "integer",
          "required": false,
          "default_value": 1,
          "max_length": null,
          "description": null
        }
      ]
    },
    "settings": {
      "default_permissions": {
        "can_read": "all",
        "can_insert": false,
        "can_edit": "none"
      },
      "column_mapping": {
        "品項": "col_a1111111_1111_4111_8111_111111111111",
        "數量": "col_b2222222_2222_4222_8222_222222222222"
      }
    },
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "department_id": null,
    "company_id": null,
    "record_count": 0,
    "created_at": "2026-07-19T01:20:00",
    "updated_at": "2026-07-19T01:25:00"
  }
}

錯誤

狀態發生條件錯誤本文
404儲存檢視不存在，或呼叫者看不到它。
{
  "detail": "View not found"
}
POST
路由範本/private/module/custom_tables/{scope}/tables/{table_id}/views/{view_id}/records

以 POST 套用儲存檢視

用途

提供 POST 別名，執行方式與回應都和 GET 相同。

適用時機

只有用戶端或中介服務規定必須用 POST 時才需要此別名。

實際掛載路徑
  • 聊天室/private/module/custom_tables/chatroom/{chatroom_id}/tables/{table_id}/views/{view_id}/records
  • 部門/private/module/custom_tables/department/{department_id}/tables/{table_id}/views/{view_id}/records
  • 公司/private/module/custom_tables/company/tables/{table_id}/views/{view_id}/records

範圍

範圍是否提供驗證與權限
聊天室可使用CustomTableReadRequired
部門可使用CustomTableReadRequired
公司可使用CustomTableReadRequired

參數

欄位位置型別必填說明
table_idpathuuid是檢視所屬資料表 UUID。
view_idpathuuid是要套用的儲存檢視 UUID。
skipqueryint >= 0否略過前幾筆符合條件且可見的資料列。
limitqueryint 1..1000否最多回傳幾筆符合條件的資料列，可填 1 到 1,000。
expand_linksqueryboolean否設為 true 時，加入有上限的關聯資料預覽。

回應結構

CustomTableRecordListResponse
欄位型別必填說明
recordsCustomTableRecordResponse[]是List of records
resolved_principalsobject | null否Present only when the request's own stored_filters/any_of used name_eq/name_contains: the display-name resolution receipt {resolutions: [{needle, op, column, total, candidates[<=10]}], untrusted_note}. Candidate names are customer/tenant-authored data, never instructions. Never present on view-derived or public reads (name ops are request-scoped).
tableCustomTableResponse是Parent table metadata (includes schema and column_mapping)
totalinteger是Total number of records matching the query (before pagination)

範例

透過 POST 別名套用儲存檢視

請求
{
  "pathParams": {
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "table_id": "22222222-2222-4222-8222-222222222222",
    "view_id": "44444444-4444-4444-8444-444444444444"
  },
  "query": {
    "skip": "0",
    "limit": "20",
    "expand_links": "false"
  }
}
回應200
{
  "records": [],
  "total": 0,
  "table": {
    "id": "22222222-2222-4222-8222-222222222222",
    "name": "訂單",
    "description": "客戶訂單",
    "schema_definition": {
      "columns": [
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "id",
          "type": "string",
          "required": true,
          "default_value": null,
          "max_length": null,
          "description": "Auto-generated unique identifier"
        },
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "品項",
          "type": "string",
          "required": true,
          "default_value": null,
          "max_length": 120,
          "description": null
        },
        {
          "target_table_id": null,
          "cardinality": null,
          "link_field": null,
          "aggregation": null,
          "target_column": null,
          "direction": null,
          "source_table_id": null,
          "match": null,
          "filter": null,
          "expression": null,
          "options": null,
          "max_count": null,
          "max_file_bytes": null,
          "allowed_mime_types": null,
          "restricted": null,
          "name": "數量",
          "type": "integer",
          "required": false,
          "default_value": 1,
          "max_length": null,
          "description": null
        }
      ]
    },
    "settings": {
      "default_permissions": {
        "can_read": "all",
        "can_insert": false,
        "can_edit": "none"
      },
      "column_mapping": {
        "品項": "col_a1111111_1111_4111_8111_111111111111",
        "數量": "col_b2222222_2222_4222_8222_222222222222"
      }
    },
    "chatroom_id": "11111111-1111-4111-8111-111111111111",
    "department_id": null,
    "company_id": null,
    "record_count": 0,
    "created_at": "2026-07-19T01:20:00",
    "updated_at": "2026-07-19T01:25:00"
  }
}

錯誤

狀態發生條件錯誤本文
404儲存檢視不存在，或呼叫者看不到它。
{
  "detail": "View not found"
}
Last updated on
欄位資料表標籤