サーバー構築不要!スマートフォンアプリ向けの新クラウド

トップ >ドキュメント >REST API リファレンス:複数オブジェクト操作

共通ドキュメント

複数オブジェクト操作

複数オブジェクト操作APIについて

クラスに対しての登録・更新・削除を一括で実行します。(会員管理は除く)
複数実行の中でエラーとなる操作があった場合もその後の処理は継続されます。

複数オブジェクト操作では、1回のリクエストで50件まで設定可能です。

このAPIのご利用は 非推奨 です。

基本仕様

  • APIパス:/batch
  • メソッド:POST

リクエストヘッダー

シグネチャやAPIキーなどの詳細は「共通フォーマット」を参照してください。

フィールド名 内容
Content-Type application/json

リクエストコンテント

追加フィールドは、対象となるクラス/フィールドに依存しており、複数存在する場合もあります。
※フィールド名に「_id」は指定不可とします。
ACL未指定時の初期値はシステム側であらかじめ設定されているデフォルト値になります。

パラメータ名 説明 データ型 必須 バリデーション
requests リクエスト 配列
リクエストの内容
パラメータ名 説明 データ型 必須 バリデーション
method メソッド 文字列 有効値チェック
path APIパス 文字列 有効値チェック
body リクエスト内容 オブジェクト フィールド名のチェック
(半角英数+「_」のみ利用可能)

メソッドでは、「POST」 or 「PUT」 or 「DELETE」の何れかを指定します。

APIパスでは、実行するAPIのパス(ドメイン部分よりも後ろのAPIパスのみ)を指定します。

リクエスト内容では、POSTを指定した時などのデータを記載します。
※フィールド名に「_id」は指定不可とします。

HTTPステータス

ステータスコード 説明
200 完了

レスポンスヘッダー

フィールド名
Content-Type application/json

レスポンスコンテント

パラメータ名 説明 データ型 備考
- 実行結果 配列

各々のコマンドの実行結果(オブジェクト)を返却します。
成功時は{"success":(実行結果)}、エラー時は{"error":(エラーコード、エラー文言)}を返却します。

リクエストサンプル

curl -X POST \
 -H "X-NCMB-Application-Key: 549116a86b0ebbec4832d4086a56f36c82a5d64bc6528fa5e6220be76db5ef45" \
 -H "X-NCMB-Timestamp: 2013-08-14T15:46:25.543" \
 -H "X-NCMB-Signature: +LRdWOaLh0Rp55FRDzyX+8mMO/S0NuDbIs0sxt7Md4w=" \
 -H "Content-Type: application/json" \
 -d '{    
      "requests":[
      {
       "method":"POST",
       "path":"2013-09-01/classes/food",
       "body":{"name":"tomato","type":"vegetable"}
       },
       {
        "method":"DELETE",
        "path":"2013-09-01/classes/food/U6TztFwTDrGSD88N",
        "body":{}
       }
      ]
     }' \
 https://mb.api.cloud.nifty.com/2013-09-01/batch

レスポンスサンプル

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

[{"success":{"createDate":"2013-08-28T10:53:52.065Z","objectId":"IIj0LLCTeXstttFA"}},{"success":null}] 

お探しの内容が見つからなかった場合はユーザーコミュニティ もご活用ください。(回答保証はいたしかねます)
なお、 Expertプラン以上のお客様はテクニカルサポートにてご質問を承らせて頂きます。

推奨画面サイズ1024×768px以上

ページの先頭へ