kintone API文件

獲取應用程式管理的使用情況

information

本頁面使用機器翻譯而成。
機器翻譯免責聲明 (External link)

目錄

information

此 API 僅適用於 Wide 版。
什麼是Wide 版？ (External link)

獲取應用程式管理的使用情況

連結已複製

獲取您具有應用程式管理許可權的應用程式使用情況的清單。
您一次最多可以獲取 100 個應用。

URL

連結已複製

https://sample.cybozu.com/k/v1/apps/statistics.json

HTTP 方法

連結已複製

GET

所需存取權限

連結已複製

  • 應用程式管理權限

請求

連結已複製

參數
參數名稱 類型 必須 說明
offset 數值或字串 可省略 從要獲取的應用清單的開頭起要跳過的應用數
如果省略，則設置為0。
limit 數值或字串 可省略 要獲取的數量
您可以指定一個介於 1 和 100 之間的整數。
如果省略，則設置為100。
範例請求（如果要在網址中包含參數 ）
URL

https://sample.cybozu.com/k/v1/apps/statistics.json?offset=1&limit=1

標頭
1
2
3

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}

有關請求頭的詳細資訊，請參閱通用規格。
kintone REST API通用規範

要求範例（如果要在要求正文中包含參數）
URL

https://sample.cybozu.com/k/v1/apps/statistics.json

標頭
1
2
3
4

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

有關請求頭的詳細資訊，請參閱通用規格。
kintone REST API通用規範

正文
1
2
3
4

{
  "offset": 0,
  "limit": 1
}

回應

連結已複製

屬性
屬性名稱 類型 說明
apps 陣列 應用程序資訊清單
apps[].id 數值或字串 應用ID
apps[].name 字串 應用程序名稱
如果為每種語言設置應用程序名稱，則會根據運行 API 的使用者設置的語言返回應用程序名稱。
apps[].space 物件 所屬空間的資訊
不屬於空間的應用將返回「null」。
apps[].space.id 數值或字串 空間ID
apps[].space.name 字串 空間名稱
apps[].appGroup 字串 應用程式群組
apps[].status 字串 應用的狀態
傳回以下選項之一：
  • CHANGED
  • NOT_ACTIVATED
  • ACTIVATED
apps[].recordUpdatedAt 字串 紀錄的最後一次添加或編輯日期
對於在 2021 年 1 月更新之前創建的應用程式，並且此後未添加或編輯任何記錄，將返回應用程式的創建日期。
apps[].recordCount 數值或字串 每個應用程式的記錄數
apps[].fieldCount 數值或字串 每個應用程式的欄位數
apps[].dailyRequestCount 數值或字串 API日請求數
apps[].storageUsage 數值或字串 附加到附件欄位的檔案的總大小
單位是Byte。
apps[].customized 布爾值 是否有對應用進行自訂
如果滿足以下條件，則返回 「true」：
  • 透過JavaScript/CSS自訂
  • 使用外掛程式進行自定義
  • 起碼有一個 「定製」 形式的清單
apps[].creator 物件 建立人的資訊
apps[].creator.code 字串 建立人的登入名稱
即使使用者已被暫停/刪除，也可以獲取。
apps[].creator.name 字串 建立人的顯示名稱
即使使用者已被暫停/刪除，也可以獲取。
apps[].createdAt 字串 建立時間
apps[].modifier 物件 上次更新空間設置的人員的資訊
apps[].modifier.code 字串 更新人登入名
即使使用者已被暫停/刪除，也可以獲取。
apps[].modifier.name 字串 更新人的顯示名稱
即使使用者已被暫停/刪除，也可以獲取。
apps[].modifiedAt 字串 應用設定的最後更新時間
示例回應
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

{
    "apps": [
        {
            "id": "1",
            "name":"案件管理",
            "space" : {
                "id": "1",
                "name": "銷售管理"
            },
            "appGroup": "Public",
            "status": "ACTIVATED",
            "recordUpdatedAt": "2023-12-04T05:45:36.000Z",
            "recordCount":"100",
            "fieldCount":"10",
            "dailyRequestCount":"1",
            "storageUsage":"47000000",
            "customized":true,
             "creator" : {
                "code": "tanaka",
                "name": "tanaka"
            },
           "createdAt": "2023-12-04T05:45:36.000Z",
           "modifier" : {
                "code": "tanaka",
                "name": "tanaka"
            },
           "modifiedAt": "2023-12-04T05:45:36.000Z"
        }
    ]
}

示例代碼

連結已複製

使用 curl 的請求
1
2
3
4
5
6

curl -X GET 'https://sample.cybozu.com/k/v1/apps/statistics.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "limit": 1
  }'
使用發送 kintone REST API 請求的 API發送請求
1
2
3
4
5

const body = {
  limit: 1
};

await kintone.api(kintone.api.url('/k/v1/apps/statistics.json', true), 'GET', body);