kintone API文件

將應用程式設置套用到正式環境

information

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

目錄

將應用程式設置套用到正式環境

連結已複製

將測試環境中的設置反映到正式環境中。
運行此API時，測試環境中應用程式的所有設置都會反映在正式環境中的應用程式中。
這相當於點擊應用程式設置畫面上的[更新應用程式]或[停止變更]。

URL

連結已複製

常規應用程式
https://sample.cybozu.com/k/v1/preview/app/deploy.json
訪客空間的應用程式
https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/preview/app/deploy.json

HTTP方法

連結已複製

POST

所需存取權限

連結已複製

  • 應用程式管理權限

請求

連結已複製

參數
參數名稱 類型 必須 說明
apps 陣列 必須 應用程式ID清單
您最多可以指定300個應用程式ID。
如果在訪客空間中指定應用程式，則只能在同一訪客空間中指定應用程式。
apps[].app 數值或字串 必須 應用程式ID
revision 數值或字串 可省略 預期修訂號
如果與實際修訂號不匹配，則會發生錯誤，並且不會變更設置。
如果指定值「-1」或未指定值，則不會驗證修訂號。
revert 布爾值或字串 可省略 是否取消對應用程式設置的變更
  • true：取消對應用程式設置的變更，並使測試環境中的應用程式設置與正式環境中的設置相同。
  • false：將應用設置中的變更反映到正式環境中
如果省略，則設置「false」。
示例請求
標頭
1
2
3
4

{
  "X-Cybozu-API-Token": "API_TOKEN",
  "Content-Type": "application/json"
}

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

正文
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

{
  "apps": [
    {
      "app": 8,
      "revision": 13
    },
    {
      "app": 9,
      "revision": 5
    },
    {
      "app": 10,
      "revision": 11
    }
  ],
  "revert": false
}

回應

連結已複製

沒有回應。

示例代碼

連結已複製

使用curl的請求

根據您的環境，curl的格式可能會有所不同。
有關說明，請參閱以下頁面。
使用curl命令執行kintone REST API中的3.執行API （日語）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

curl -X POST 'https://sample.cybozu.com/k/v1/preview/app/deploy.json' \
  -H 'X-Cybozu-API-Token: API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "apps": [
      {
        "app": 1,
        "revision": 57
      },
      {
        "app": 1001,
        "revision": 22
      }
    ],
    "revert": false
  }'
使用kintone.api()發送請求

有關詳細的kintone.api()，請參閱以下頁面。
傳送kintone REST API請求 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

const body = {
  apps: [
    {
      app: 1,
      revision: 57
    },
    {
      app: 1001,
      revision: 22
    }
  ],
  revert: false
};

await kintone.api(kintone.api.url('/k/v1/preview/app/deploy.json'), 'POST', body);
information

有關在測試環境中創建應用程式、更改設置並將其反映在正式版應用程式的步驟，請參閱以下頁面。
創建應用和變更設置的流程