[kintone] エラーコード「GAIA_IQ27」が発生した時の対処方法

先日、kintoneのAPIを使って、kintoneの情報を更新しようとしたところエラーコード「GAIA_IQ27」が発生しました。

その時の対処方法を記載します。

やろうとしていたこと

kintoneのAPI（record.json）を使って、PUTメソッドでkintoneの情報を更新しようとしました。curlコマンドでサンプルを記載すると以下の通りです。

curl -X PUT 'https://sample.cybozu.com/k/v1/record.json' \
  -H 'X-Cybozu-API-Token: API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "app": 1,
  "updateKey": {
    "field": "user_id",
    "value": "0001"
  },
  "record": {
    "update_item": {
      "value": "更新後のデータ"
    },
  }
}

すると、エラー「GAIA_IQ27」が発生しました。

X-Cybozu-Error:[GAIA_IQ27]

エラーコード「GAIA_IQ27」の内容

エラーコード「GAIA_IQ27」の内容は以下の通りです。

「updateKey」に指定するフィールド（code: user_id）は、フィールドの設定で値の重複を禁止する必要があります。

解決方法

「record.json」は、1件のレコードを更新するAPIになります。そのため、キーで検索したときに、レコードが一意に決まる必要があります。

「record.json」のキー項目の指定には、idとupdateKeyの2種類があります。

idの場合は、必然的にレコードが一意に決まるのですが、updateKeyの場合は、指定したフィールド（今回の場合「user_id」）が、一意である必要があります。

つまり、「user_id」が一意になるように、フォームの設定画面で「値の重複を禁止する」にチェックを入れて保存すればよいです。

これでエラーは解消されました。

以上、『kintone エラーコード「GAIA_IQ27」が発生した時の対処方法』でした。