複数アプリへのレコード一括処理

複数アプリへのレコード一括処理

複数のアプリに対して、同時に複数の APIをリクエストできます。

HTTP メソッド

POST

URI

https://(サブドメイン名).cybozu.com/k/v1/bulkRequest.json

ゲストスペース内のアプリの場合

https://(サブドメイン名).cybozu.com/k/guest/<スペースのID>/v1/bulkRequest.json

• 同じゲストスペース内のアプリへの一括更新のみ実行でき、次の処理は実行することができません。
  • ゲストスペース内のアプリと、別のゲストスペース内のアプリへの一括更新
  • ゲストスペース内のアプリと、スペース内のアプリへの一括更新
  • ゲストスペース内のアプリと、通常のアプリへの一括更新

必要なアクセス権

実行するAPIの必要な権限に準ずる

リクエストパラメータ

リクエストの例

リクエストヘッダ

 POST /k/v1/bulkRequest.json HTTP/1.1
Host: example.cybozu.com:443
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
Content-Type: application/json

• Content-Type に application/json を指定して下さい。 指定しない場合は JSON が解釈できないため、実行時エラーとなります。

ボディ

レスポンス

resultsの配列にrequestsと同じインデックスの箇所に結果が入ります。

成功した例

失敗した例

2つ目のPUTリクエストで、更新する id がない場合にエラーとなる例です。 失敗したAPIがあればそのインデックスにのみ結果が入り、それ以降のAPIは実行されずに {} (空のObject) となります。

JavaScriptサンプル

kintone REST API

XMLHttpRequest