獲取清單設置
獲取應用清單的設置。
URL
獲取正式環境的設置時,URL 與獲取測試環境的設置時不同。
如果要獲取正式環境的設置
- 常規應用程式
- https://sample.cybozu.com/k/v1/app/views.json
- 訪客空間的應用程式
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/app/views.json
獲取操作測試環境的設置
- 常規應用程式
- https://sample.cybozu.com/k/v1/preview/app/views.json
- 訪客空間的應用程式
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/preview/app/views.json
HTTP 方法
GET
所需存取權限
如果要獲取正式環境的設置
您必須具有以下權限之一:
- 應用程式中記錄的查看權限
- 應用程式中新增記錄的權限
獲取操作測試環境的設置
- 應用程式管理權限
請求
參數
參數名稱 | 類型 | 必須 | 說明 |
---|---|---|---|
app | 數值 | 必須 | 應用ID |
lang | 字串 | 可省略 | 要選取的名稱的語言 如果為欄位或選項的名稱設置了多語言對應,請指定。 多語言對應
|
範例請求(如果要在網址中包含參數 )
URL
https://sample.cybozu.com/k/v1/app/views.json?app=8&lang=ja
標頭
|
|
有關請求頭的詳細資訊,請參閱通用規格。
kintone REST API通用規範
要求範例(如果要在要求內文中包含參數)
URL
https://sample.cybozu.com/k/v1/app/views.json
標頭
|
|
有關請求頭的詳細資訊,請參閱通用規格。
kintone REST API通用規範
內文
|
|
回應
屬性
屬性名稱 | 類型 | 說明 |
---|---|---|
views | 物件 | 設定清單 |
views.清單名稱 |
字串 | 每個清單的設置 |
views.清單名稱 .type |
字串 | 清單顯示格式
|
views.清單名稱 .builtinType |
字串 | 清單名稱 僅當「(我的工作)」時輸出的屬性返回「ASSIGNEE」。 啟用行程管理功能時,會自動創建「(我的工作)」清單。 |
views.清單名稱 .name |
字串 | 清單名稱 |
views.清單名稱 .id |
字串 | 清單的ID |
views.清單名稱 .fields |
陣列 | 要顯示的欄位的欄位代碼清單views.清單名稱.type 為「LIST」時返回。 |
views.清單名稱 .date |
字串 | 要用於顯示日期的欄位的欄位代碼views.清單名稱.type 為「CALENDAR」時返回。 |
views.清單名稱 .title |
字串 | 要用於顯示標題的欄位的欄位代碼views.清單名稱.type 為「CALENDAR」返回。 |
views.清單名稱 .html |
字串 | 用於自訂的 HTML 內容views.清單名稱.type 為「CUSTOM」時返回。 |
views.清單名稱 .pager |
布爾值 | 分頁顯示
views.清單名稱.type 為「CUSTOM」時返回。 |
views.清單名稱 .device |
字串 | 清單的顯示範圍
views.清單名稱.type 為「CUSTOM」時返回。 |
views.清單名稱 .filterCond |
字串 | 記錄篩選條件 它以查詢的形式表示。有關查詢格式的詳細資訊,請參閱以下頁面。 如何編寫查詢 |
views.清單名稱 .sort |
字串 | 記錄排序 它以查詢的形式表示。有關查詢格式的詳細資訊,請參閱以下頁面。 如何編寫查詢 |
views.清單名稱 .index |
字串 | 清單顯示順序(升序) |
revision | 字串 | 應用設置的修訂號 |
應答範例
|
|
示例代碼
使用 curl 的請求
|
|
kintone.api()
請求使用
有關詳細的kintone.api()
,請參閱以下頁面。
發送kintone REST API請求
|
|
限制
- 如果存在同名清單,則無法獲取設置。