複数のレコードを登録する

目次

複数のレコードを登録する

複数のレコードを登録します。

  • 一度に登録できるレコードは 100 件までです。
  • 必須項目が設定されている場合には、その値をリクエストに含めてください。
  • リクエストパラメーターの records に指定した順番でレコードを登録します。またレスポンスのレコード ID の順序もその順番に対応します。
  • 処理に失敗すると、リクエストに指定したレコードの登録はすべてキャンセルされます。

URL

通常のアプリ
https://sample.cybozu.com/k/v1/records.json
ゲストスペースのアプリ
https://sample.cybozu.com/k/guest/SPACE_ID/v1/records.json

HTTP メソッド

POST

必要なアクセス権

  • アプリのレコード追加権限
  • 値を登録するレコードの編集権限
  • 値を登録するフィールドの編集権限

次のフィールドに値を登録する場合、アプリ管理権限が必要です。

  • 作成者
  • 更新者
  • 作成日時
  • 更新日時

リクエスト

パラメーター
パラメーター名 必須 説明
app 数値または文字列 必須 アプリ ID
records 配列(オブジェクト) 必須 登録するレコードの一覧
フィールドの種類によって、指定できる値が異なります。
詳細は フィールド形式 を確認してください。
空配列を指定した場合は、すべてのフィールドの値は初期値で登録されます。
存在しないフィールドコードを指定した場合、そのフィールドは無視されてレコードが登録されます。
リクエストの例
ヘッダー
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
18
19
20
21
{
  "app": 1,
  "records": [
    {
      "文字列1行_0": {
        "value": "ABC"
      },
      "文字列1行_1": {
        "value": "ABC"
      }
    },
    {
      "文字列1行_0": {
        "value": "EFG"
      },
      "文字列1行_1": {
        "value": "EFG"
      }
    }
  ]
}

レスポンス

プロパティ
プロパティ名 説明
ids 配列(文字列) 登録したレコードのレコード ID
revision 配列(文字列) 登録したレコードのリビジョン番号

レコード ID の順序はリクエストに指定したレコードの順序と対応します。

レスポンスの例
1
2
3
4
{
  "ids": ["100", "101"],
  "revisions": ["1", "1"]
}

サンプルコード

curl を使ったリクエスト
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
curl -X POST 'https://sample.cybozu.com/k/v1/records.json' \
  -H 'X-Cybozu-API-Token: API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "app": 1,
    "records": [
      {
        "文字列1行_0": {
          "value": "ABC"
        },
        "文字列1行_1": {
          "value": "ABC"
        }
      },
      {
        "文字列1行_0": {
          "value": "EFG"
        },
        "文字列1行_1": {
          "value": "EFG"
        }
      }
    ]
  }'
kintone REST API リクエストを送信する API を使ったリクエスト
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
const body = {
  app: kintone.app.getId(),
  records: [
    {
      文字列1行_0: {
        value: 'ABC'
      },
      文字列1行_1: {
        value: 'ABC'
      }
    },
    {
      文字列1行_0: {
        value: 'EFG'
      },
      文字列1行_1: {
        value: 'EFG'
      }
    }
  ]
};

await kintone.api(kintone.api.url('/k/v1/records.json', true), 'POST', body);