KAC kintone

kintone と連携しレコードを操作する

リリース予定：済
最新バージョン：1.0
最新バージョンリリース日：2024/11/01

仕様・制限事項

KAC のカウントアップはされません。
カスタムコネクタの JSON は「KAC kintone AppConverter」で取得できます。
詳細な仕様については公式ドキュメントを参照してください。https://cybozu.dev/ja/kintone/docs/rest-api

サインインに必要な情報

SubDomain: kintone: アプリのサブドメイン
APIトークン: kintone アプリの APIトークン
AppId: kintone アプリの ID

1件のレコードを取得

1件のレコードを登録

1件のレコードを更新(ID指定)

1件のレコードを更新(フィールド・値指定)

1件のレコードを取得

指定した1件のレコードを取得します。

パラメータ

AppID: アプリ ID
RecordID: レコード ID

レスポンス

kintone API ドキュメント「1件のレコードを取得」参照: https://cybozu.dev/ja/kintone/docs/rest-api/records/get-record/

1件のレコードを登録

1件のレコードを登録します。

パラメータ

AppID: アプリ ID

レスポンス

kintone API ドキュメント「1件のレコードを登録する」参照: https://cybozu.dev/ja/kintone/docs/rest-api/records/add-record/

1件のレコードを更新(ID指定)

指定した1件のレコードを更新します。

パラメータ

AppID: アプリ ID
RecordID: レコード ID
Revision: 期待しているリビジョン番号。値に「-1」を指定する、または指定しなかった場合はリビジョン番号は検証されません。
フィールド名（アプリにあるフィールドの名称）: フィールドに入力する値

※アプリ内のフィールドの数によってパラメータ数が変わります。

レスポンス

kintone API ドキュメント「1件のレコードを更新する」参照: https://cybozu.dev/ja/kintone/docs/rest-api/records/update-record/

1件のレコードを更新(フィールド・値指定)

指定した1件のレコードを更新します。

パラメータ

AppID: アプリ ID
updateKey_field: 重複禁止を設定した「文字列（1行）」または「数値」フィールドを選択
updateKey_value: updateKey.field で指定したフィールドを、指定した値で検索し、ヒットした1レコードを更新する
Revision: 期待しているリビジョン番号。値に「-1」を指定する、または指定しなかった場合はリビジョン番号は検証されません。
フィールド名（アプリにあるフィールドの名称）: フィールドに入力する値

※アプリ内のフィールドの数によってパラメータ数が変わります。

レスポンス

kintone API ドキュメント「1件のレコードを更新する」参照: https://cybozu.dev/ja/kintone/docs/rest-api/records/update-record/

1件のレコードを削除

指定した1件のレコードを削除します。

パラメータ

AppID: アプリ ID
RecordIDs: 複数レコードを指定する場合はカンマ区切りで入力してください。
Revision: 期待しているリビジョン番号。値に「-1」を指定する、または指定しなかった場合はリビジョン番号は検証されません。

レスポンス

kintone API ドキュメント「複数のレコードを削除する」参照: https://cybozu.dev/ja/kintone/docs/rest-api/records/delete-records/

コメントを取得

指定したレコードへのコメントを取得します。

パラメータ

AppID: アプリ ID
RecordID: レコード ID
order: 取得するコメントの並び順
offset: 取得するコメントの先頭からスキップする数
limit: 取得するコメント数の上限 0~10まで。デフォルトは10

レスポンス

kintone API ドキュメント「レコードコメントを取得する」参照: https://cybozu.dev/ja/kintone/docs/rest-api/records/get-comments/

コメントを投稿

指定のレコードにコメントを投稿します。

パラメータ

AppID: アプリ ID
RecordID: レコード ID
コメント本文: コメントの内容。最大文字数は65,535文字です。
宛先ユーザ,組織/グループ: 宛先のユーザー/組織/グループコード、上限は１０
- 宛先ユーザー/組織/グループ: 宛先ユーザー、ゲストユーザを指定する場合は、「guest/宛先ユーザーアドレス」と指定する必要があります。
- ユーザ/組織/グループ: ユーザ/組織/グループのコードを選択

レスポンス

kintone API ドキュメント「レコードコメントを投稿する」参照: https://cybozu.dev/ja/kintone/docs/rest-api/records/add-comment/

コメントを削除

指定したレコードのコメントを削除する

パラメータ

AppID: アプリ ID
RecordID: レコード ID
CommentID: コメント ID

レスポンス

kintone API ドキュメント「レコードコメントを削除する」参照: https://cybozu.dev/ja/kintone/docs/rest-api/records/delete-comment/