kintone API

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

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

目次

HTTPメソッドGET
URLhttps://sample.cybozu.com/k/v1/preview/app/deploy.json
URL(ゲストスペース)https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/preview/app/deploy.json
認証 パスワード認証 , APIトークン認証 , セッション認証 , OAuth認証
Content-Typeapplication/json(クエリ文字列でクエリを指定する場合は不要)

リクエストパラメーター

パラメーター名 必須 説明
apps 配列(数値または文字列) 必須 アプリIDの一覧
最大で300のアプリIDを指定できます。
ゲストスペースのアプリを指定する場合、同じゲストスペースのアプリのみ指定できます。

レスポンスプロパティ

プロパティ名 説明
apps 配列 処理の状況を表すオブジェクトの配列
apps[].app 文字列 アプリID
apps[].status 文字列 処理の進捗
  • PROCESSING:処理中
  • SUCCESS:処理の完了
  • FAIL:処理の失敗
  • CANCEL:他のアプリで処理が失敗したことによる、処理のキャンセル

必要なアクセス権

  • アプリ管理権限

サンプル

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

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

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

 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"
    }
  ]
}

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);

ご利用の環境によって、curlのフォーマットは異なる場合があります。
詳細は、次のページを参照してください。
curlコマンドでkintone REST APIを実行してみよう/3.API実行

1
2
3
4
5
6
curl -X GET 'https://sample.cybozu.com/k/v1/preview/app/deploy.json' \
  -H 'X-Cybozu-API-Token: API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "apps": [8, 9, 10]
  }'

補足