アプリの設定の運用環境への反映状況を確認する

目次

アプリの設定の運用環境へ反映状況を確認する

アプリの設定の運用環境への反映状況を確認します。
アプリの設定を運用環境へ反映するAPIでの処理の進捗を確認できます。
アプリの設定を運用環境へ反映する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メソッド

GET

必要なアクセス権

  • アプリ管理権限

リクエスト

パラメーター
パラメーター名 必須 説明
apps 配列(数値または文字列) 必須 アプリIDの一覧
最大で300のアプリIDを指定できます。
ゲストスペースのアプリを指定する場合、同じゲストスペースのアプリのみ指定できます。
リクエストの例
ヘッダー
1
2
3
4
{
  "X-Cybozu-Token": "API_TOKEN",
  "Content-Type": "application/json"
}

リクエストヘッダーの詳細は共通仕様を参照してください。
kintone REST APIの共通仕様

ボディ
1
2
3
{
  "apps": [8, 9, 10]
}

レスポンス

プロパティ
プロパティ名 説明
apps 配列 処理の状況を表すオブジェクトの配列
apps[].app 文字列 アプリID
apps[].status 文字列 処理の進捗
  • PROCESSING:処理中
  • SUCCESS:処理の完了
  • FAIL:処理の失敗
  • CANCEL:他のアプリで処理が失敗したことによる、処理のキャンセル
レスポンスの例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
  "apps": [
    {
      "app": "8",
      "status": "PROCESSING"
    },
    {
      "app": "9",
      "status": "PROCESSING"
    },
    {
      "app": "10",
      "status": "PROCESSING"
    }
  ]
}

サンプルコード

curlを使ったリクエスト
1
2
3
4
5
6
curl -X GET 'https://sample.cybozu.com/k/v1/preview/app/deploy.json' \
  -H 'X-Cybozu-Token: API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "apps": [8, 9, 10]
  }'
kintone.api()を使ったリクエスト

kintone.api()の詳細は、次のページを参照してください。
kintone REST APIリクエストを送信する

1
2
3
4
5
const body = {
  apps: [8, 9, 10]
};

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