君はいくつ見たことがある？ kintone のエラー番号

こんにちは！金春です。

弊社では gusuku Customine の開発やお客様からご依頼いただいた kintone 開発で日々色々な形で kintone REST API を呼び出しています。

そして、API呼び出しにつきものなのがエラーです。 kintone は様々なケースでいろんなエラーを返してくるのですが、それをまとめたものがありません。

みなさんもエラーがでてこんな感じになったことありませんか？

今回は弊社が把握しているエラーの一覧を作成してみました。他にも知ってるというあれば教えてください！

なんかエラーが出た！という時はこれをみてみてください。

kintone のエラー一覧（2021.2.4時点で把握しているもの）

エラーコード	エラー内容	ひとこと
GAIA_FU01	フィールド「XXXXX」の編集権限がありません。	APIで呼ぶときは神だと思いがちですが、権限チェックはちゃんとされているのでご注意を
GAIA_IL23	ゲストスペース内のアプリを操作する場合は、リクエストの送信先を「/k/guest/（ゲストスペースのID）/v1/…」	AppIDはゲストスペースのアプリを指しているのにリクエストURLがゲストスペースでない場合
GAIA_IL26	指定したユーザー（code：XXXXXX）が見つかりません。	古いデータに含まれるユーザー選択の人がもういないなんて時に起きがちです
GAIA_IL28	指定した組織（code：XXXXXX）が見つかりません。	上に同じw
GAIA_IL42	レコードの絞り込み条件に指定したユーザー、グループ、または組織が存在しません。削除された可能性があります。	これも古い一覧の定義とか、一覧用のクエリとか使うと起きがち
GAIA_IQ03	作業者フィールドのフィールドタイプには演算子=を使用できません。	フィールドタイプと演算子の組み合わせが不正な場合に出る模様
GAIA_IQ07	レコードを読み込めません。テーブルに設定している場合、数値フィールドのフィールドタイプには、演算子=を使用できません。	テーブルのときは「in」ってことです
GAIA_IQ11	指定されたフィールド（XXXX）が見つかりません。	カスタマイズ入れたあとにフィールドいじるときは要注意ですね、あ〜〜〜〜プログラムから使ってた！！！ってやりがちです
GAIA_IR02	フィールド「xxxxx」に指定したクエリが正しくありません。指定したクエリは、関連レコード一覧フィールドでのみ使用できます。	グループ選択.code = “aaa”とクエリ指定すると、関連レコードと誤認識するらしい
GAIA_LO03	ルックアップの参照先から値をコピーできません。「コピー元のフィールド」に指定したフィールドの設定で「値の重複を禁止する」を選択しておく必要があります。	APIでルックアップに値を入れるときはコピー元のキーが重複禁止でないとこのエラーが出ます。やりがちなミス
GAIA_LT01 GAIA_DA02	データベースがロックされているため、操作に失敗しました。時間をおいて再度お試しください。	勢いよく書き込みをしようとしたりするとでることがあります。あるいはAPIでレコード更新しようとしているアプリがアプリの設定変更中だったりするとでることがあります。そしてLT01とDA02の違いは謎
GAIA_NT01	作業者のみがステータスを変更できます	Administratorであっても作業者でないとステータスは変更できないのでご注意を
GAIA_NO01	このAPIトークンでは、指定したAPIを実行できません。	これが嫌だからといって不必要にAPIトークンに権限つけるのはやめましょう
GAIA_TM12	作成できるカーソルの上限に達しているため、カーソルを作成できません。不要なカーソルを削除するか、しばらく経ってから再実行してください。	正直ドメイン全体でカーソルが何個あるか把握してこれがでないようなプログラム書くのは至難の業だと思います
GAIA_UN03	レコードを再読み込みしてください。編集中に、ほかのユーザーがレコードを更新しました	これはすごくよく見ますよね、非同期呼び出しが複数の処理で同じレコード更新したりするとこれがすぐにでます。でもそれはプログラムが悪いってことなのでkintoneにせいにしちゃダメです
CB_IJ01	不正なJSON文字列です。	パラメーターに渡したJSONがおかしいってことですね、文字列結合で組み立てたりすると起きがちです。ちなみに、JSONとしては正しくても配列を受け取るパラメーターに空文字列を入れるとこれが発生します
CB_IL02	謎のエラー	このエラーは謎です。なにかkintoneにとって都合が悪いことがあるとこれが出ますが、なぜそうなるのかはわからないことが多いです
CB_TW02	2要素認証を有効にしているため、認証できません。REST APIでは2要素認証はサポートされていません。	うっかり自分のアカウントを2要素認証に変えて社内で自分のアカウントで連携させてたサービスが死んだのは内緒ですw
CB_VA01	クエリ記法が間違っています。	kintoneクエリってシンプルなんですが、なぜかこれがよく出ますw