警告
このページで説明しているAPIは、開発を検討中のAPIです。
アップデートオプション内の「開発中の新機能」から動作をお試しいただけます。
設定方法は、
新機能の有効/無効の切り替え手順
を参照してください。
API
に関するフィードバックを、ユースケースとともに、
kintoneの改善に協力する
フォームへぜひご登録ください。
- フィードバックの例
- APIラボで提供されているAPIを早く本番環境で利用したい
- こういう用途で使うために、このようなAPIを提供してほしい
プロセス管理の設定を取得する
プロセス管理の設定を取得するAPI で、アクションの種類とアクションの実行可能ユーザーの情報を追加で取得できます。
利用するには開発中の新機能の「プロセス管理の設定で、作業者以外でも実行できるアクションを設定できる機能」を有効にしてください。
URL
URLは運用環境の設定を取得する場合と、動作テスト環境の設定を取得する場合とで異なります。
運用環境の設定を取得する場合
- 通常のアプリ
- https://sample.cybozu.com/k/v1/app/status.json
- ゲストスペースのアプリ
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/app/status.json
動作テスト環境の設定を取得する場合
- 通常のアプリ
- https://sample.cybozu.com/k/v1/preview/app/status.json
- ゲストスペースのアプリ
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/preview/app/status.json
HTTPメソッド
GET
必要なアクセス権
運用環境の設定を取得する場合
次のいずれかの権限が必要です。
- アプリのレコード閲覧権限
- アプリのレコード追加権限
動作テスト環境の設定を取得する場合
- アプリ管理権限
リクエスト
パラメーター
パラメーター名 | 型 | 必須 | 説明 |
---|---|---|---|
app | 数値または文字列 | 必須 | アプリID |
lang | 文字列 | 省略可 | 取得する名称の言語 カテゴリー名に 言語ごとの名称
|
レスポンス
プロセス管理の設定を取得するAPI のレスポンスに以下の項目が追加されます。
プロパティ
プロパティ名 | 型 | 説明 |
---|---|---|
actions[].type | 文字列 | アクションの種類
|
actions[].executableUser | オブジェクト | アクションの実行可能ユーザーactions[].type がGENERAL の場合のみレスポンスに含まれます。 |
actions[].executableUser.entities | 配列 | アクションの実行可能ユーザーの情報 空配列の場合は、レコード閲覧可能なユーザー全員が実行可能なアクションとして扱われます。 |
actions[].executableUser.entities[].entity | オブジェクト | アクションの実行可能ユーザーの情報 削除済み、または無効なユーザー、組織およびグループはレスポンスに含まれません。 |
actions[].executableUser.entities[].entity.type | 文字列 | アクションの実行可能ユーザーの指定形式
|
actions[].executableUser.entities[].entity.code | 文字列 | アクションの実行可能ユーザーのコードentity.type の値によって異なります。
|
actions[].executableUser.entities[].includeSubs | 真偽値 | 設定を下位組織に継承するかどうか
entity.type が「ORGANIZATION」か、「FIELD_ENTITY」で組織選択フィールドが指定されている場合のみ、「true」が返ります。 |
レスポンスの例
|
|