kintone REST APIの使い方は、次のチュートリアルを参照してください。
kintone REST APIを使ってみよう
レコード
レコードの取得/登録/更新/削除
HTTPメソッド | URL | |
---|---|---|
1件のレコードを取得する | GET | /k/v1/record.json |
1件のレコードを登録する | POST | /k/v1/record.json |
1件のレコードを更新する | PUT | /k/v1/record.json |
複数のレコードを取得する | GET | /k/v1/records.json |
複数のレコードを登録する | POST | /k/v1/records.json |
複数のレコードを更新する | PUT | /k/v1/records.json |
複数のレコードを削除する | DELETE | /k/v1/records.json |
(レコードの一括取得)カーソルを作成する | POST | /k/v1/records/cursor.json |
(レコードの一括取得)カーソルからレコード取得を取得する | GET | /k/v1/records/cursor.json |
(レコードの一括取得)カーソルを削除する | DELETE | /k/v1/records/cursor.json |
レコードのコメントの操作
HTTPメソッド | URL | |
---|---|---|
レコードのコメントを取得する | GET | /k/v1/record/comments.json |
レコードにコメントを投稿する | POST | /k/v1/record/comment.json |
レコードのコメントを削除する | DELETE | /k/v1/record/comment.json |
プロセス管理の操作
HTTPメソッド | URL | |
---|---|---|
レコードの作業者を更新する | PUT | /k/v1/record/assignees.json |
1件のレコードのステータスを更新する | PUT | /k/v1/record/status.json |
複数のレコードのステータスを更新する | PUT | /k/v1/records/status.json |
その他
HTTPメソッド | URL | |
---|---|---|
複数アプリのレコード操作を一括処理する | POST | /k/v1/bulkRequest.json |
APIを実行したユーザーのレコードのアクセス権の設定を取得する | GET | /k/v1/records/acl/evaluate.json |
ファイル
HTTPメソッド | URL | |
---|---|---|
ファイルをダウンロードする | GET | /k/v1/file.json |
ファイルをアップロードする | POST | /k/v1/file.json |
アプリ
アプリに関するAPIには、2つのURLがあります。
詳細は、各ドキュメントを確認してください。
- アプリの動作を確認するテスト環境に反映するURL:「/k/v1/preview/
API_PATH
.json」 - 本番環境に反映するURL:「/k/v1/
API_PATH
.json」
アプリ情報
HTTPメソッド | URL | 備考 | |
---|---|---|---|
1件のアプリの情報を取得する | GET | /k/v1/app.json | |
複数のアプリの情報を取得する | GET | /k/v1/apps.json | |
動作テスト環境にアプリを作成する | POST | /k/v1/preview/app.json | |
アプリの使用状況を取得する | GET | /k/v1/apps/statistics.json | ワイドコースのみ |
アプリ管理者用メモを取得する | GET |
/k/v1/app/adminNotes.json /k/v1/preview/app/adminNotes.json |
|
アプリ管理者用メモを変更する | PUT | /k/v1/preview/app/adminNotes.json |
フォーム
HTTPメソッド | URL | |
---|---|---|
フィールドを取得する | GET |
/k/v1/app/form/fields.json /k/v1/preview/app/form/fields.json |
フィールドを追加する | POST | /k/v1/preview/app/form/fields.json |
フィールドの設定を変更する | PUT | /k/v1/preview/app/form/fields.json |
フィールドを削除する | DELETE | /k/v1/preview/app/form/fields.json |
フォームのレイアウトを取得する | GET |
/k/v1/app/form/layout.json /k/v1/preview/app/form/layout.json |
フォームのレイアウトを変更する | PUT | /k/v1/preview/app/form/layout.json |
フォームの設計情報を取得する | GET |
/k/v1/form.json /k/v1/preview/form.json |
一覧
HTTPメソッド | URL | |
---|---|---|
一覧の設定を取得する | GET |
/k/v1/app/views.json /k/v1/preview/app/views.json |
一覧の設定を変更する | PUT | /k/v1/preview/app/views.json |
グラフ
HTTPメソッド | URL | |
---|---|---|
グラフの設定を取得する | GET |
/k/v1/app/reports.json /k/v1/preview/app/reports.json |
グラフの設定を変更する | PUT | /k/v1/preview/app/reports.json |
アプリの設定
一般設定
HTTPメソッド | URL | |
---|---|---|
アプリの一般設定を取得する | GET |
/k/v1/app/settings.json /k/v1/preview/app/settings.json |
アプリの一般設定を変更する | PUT | /k/v1/preview/app/settings.json |
プロセス管理の設定を取得する | GET |
/k/v1/app/status.json /k/v1/preview/app/status.json |
プロセス管理の設定を変更する | PUT | /k/v1/preview/app/status.json |
アプリの設定の運用環境への反映状況を確認する | GET | /k/v1/preview/app/deploy.json |
アプリの設定を運用環境へ反映する | POST | /k/v1/preview/app/deploy.json |
カスタマイズ/サービス連携
HTTPメソッド | URL | |
---|---|---|
アプリに追加されているプラグインの一覧を取得する | GET |
/k/v1/app/plugins.json /k/v1/preview/app/plugins.json |
アプリにプラグインを追加する | POST | /k/v1/preview/app/plugins.json |
JavaScript / CSS カスタマイズ設定を取得する | GET |
/k/v1/app/customize.json /k/v1/preview/app/customize.json |
JavaScript / CSS カスタマイズ設定を変更する | PUT | /k/v1/preview/app/customize.json |
通知
HTTPメソッド | URL | |
---|---|---|
アプリの条件通知の設定を取得する | GET |
/k/v1/app/notifications/general.json /k/v1/preview/app/notifications/general.json |
アプリの条件通知の設定を変更する | PUT | /k/v1/preview/app/notifications/general.json |
レコードの条件通知の設定を取得する | GET |
/k/v1/app/notifications/perRecord.json /k/v1/preview/app/notifications/perRecord.json |
レコードの条件通知の設定を変更する | PUT | /k/v1/preview/app/notifications/perRecord.json |
リマインダーの条件通知の設定を取得する | GET |
/k/v1/app/notifications/reminder.json /k/v1/preview/app/notifications/reminder.json |
リマインダーの条件通知の設定を変更する | PUT | /k/v1/preview/app/notifications/reminder.json |
アクセス権
HTTPメソッド | URL | |
---|---|---|
アプリのアクセス権の設定を取得する | GET |
/k/v1/app/acl.json /k/v1/preview/app/acl.json |
アプリのアクセス権の設定を変更する | PUT |
/k/v1/app/acl.json /k/v1/preview/app/acl.json |
レコードのアクセス権の設定を取得する | GET |
/k/v1/record/acl.json /k/v1/preview/record/acl.json |
レコードのアクセス権の設定を変更する | PUT |
/k/v1/record/acl.json /k/v1/preview/record/acl.json |
フィールドのアクセス権の設定を取得する | GET |
/k/v1/field/acl.json /k/v1/preview/field/acl.json |
フィールドのアクセス権の設定を変更する | PUT |
/k/v1/field/acl.json /k/v1/preview/field/acl.json |
その他の設定
HTTPメソッド | URL | |
---|---|---|
アプリのアクション設定を取得する | GET |
/k/v1/app/actions.json /k/v1/preview/app/actions.json |
アプリのアクション設定を変更する | PUT | /k/v1/preview/app/actions.json |
運用管理
HTTPメソッド | URL | |
---|---|---|
アプリの所属するスペースを変更する | POST | /k/v1/app/move.json |
スペース
スペース
HTTPメソッド | URL | 備考 | |
---|---|---|---|
スペースの情報を取得する | GET | /k/v1/space.json | |
スペースの設定を変更する | PUT | /k/v1/space.json | |
スペースを作成する | POST | /k/v1/template/space.json | |
スペースを削除する | DELETE | /k/v1/space.json | |
スペースの本文を更新する | PUT | /k/v1/space/body.json | |
スペースのメンバーとスペース管理者の情報を取得する | GET | /k/v1/space/members.json | |
スペースのメンバーを更新する | PUT | /k/v1/space/members.json | |
スペースの使用状況を取得する | GET | /k/v1/space/statistics.json | ワイドコースのみ |
スレッド
HTTPメソッド | URL | |
---|---|---|
スペースのスレッドを作成する | POST | /k/v1/space/thread.json |
スペースのスレッドを更新する | PUT | /k/v1/space/thread.json |
スペースのスレッドにコメントを投稿する | POST | /k/v1/space/thread/comment.json |
ゲストユーザーとゲストスペース
HTTPメソッド | URL | |
---|---|---|
ゲストユーザーを追加する | POST | /k/v1/guests.json |
ゲストユーザーを削除する | DELETE | /k/v1/guests.json |
ゲストスペースのゲストメンバーを更新する | PUT |
/k/guest/GUEST_SPACE_ID /v1/space/guests.json
|
プラグイン
HTTPメソッド | URL | |
---|---|---|
インストール済みのプラグインの一覧を取得する | GET | /k/v1/plugins.json |
インストールが必要なプラグインの一覧を取得する | GET | /k/v1/plugins/required.json |
プラグインを追加しているアプリの一覧を取得する | GET | /k/v1/plugin/apps.json |
プラグインを読み込む | POST | /k/v1/plugin.json |
プラグインを更新する | PUT | /k/v1/plugin.json |
プラグインをアンインストールする | DELETE | /k/v1/plugin.json |
API情報
HTTPメソッド | URL | |
---|---|---|
kintone REST APIの一覧を取得する | GET | /k/v1/apis.json |
kintone REST APIのスキーマ情報を取得する | GET | /k/v1/apis/*.json |