API ビルダー

Liferay DXP 2023.Q4+/Portal 7.4 GA102+ Beta Feature

important

APIビルダーはベータ機能で、現在はLiferayオブジェクトのみをサポートしています。 APIエンドポイントは現在、エンティティのコレクションの取得をサポートしている。

APIビルダーを使えば、LiferayでカスタムAPIアプリケーションを簡単に作成できます。 お客様のニーズを正確に満たすAPIスキーマとエンドポイントを作成します。

APIビルダーを有効にする、

  1. グローバルメニューに移動する(! グローバルメニューコントロールパネルインスタンス設定 .

  2. プラットフォーム」の下にある「機能フラグ」をクリックします。

  3. 左のナビゲーションで Beta を選択。 APIビルダーをオンにする。 APIビルダーが有効になりました。

APIアプリケーションを理解する

各カスタムAPIアプリケーションは複数のエンドポイントとスキーマを持つことができる。 これはLiferayのすぐに使えるAPIアプリケーションに似ている。 例えば、headless-admin-user API アプリケーションには accountsorganizationsrolesuser-accounts などのエンドポイントがある。

カスタムAPIアプリケーションを管理するには、 Global Menu( Global Menu ) に移動します。 → コントロールパネルAPIビルダー . カスタムAPIアプリケーションのリストをご覧ください。 APIアプリケーションごとに、タイトル、URL、説明、最終更新日、ステータスが表示される。

See a list of your custom API applications.

新しいAPIアプリケーションを作成するには、 AddAdd icon )をクリックし、詳細を入力します。

アプリケーションを編集または削除するには、 Options(Options icon) をクリックし、 Edit または Delete をクリックします。 なお、ドラフト状態のAPIアプリケーションは、公開後でなければ使用できない。 いったん公開されると、生成されたAPIはLiferayのすぐに使えるAPIと同じ機能を持ちます(ページネーション、フィルタリング、ソートなど)。

スキーマを理解する

APIスキーマは、APIが返す(あるいは受け取る)エンティティを指定する。 スキーマを管理するには、カスタムAPIアプリケーションの1つをクリックし、 Schemas タブをクリックします。 カスタムスキーマの一覧を見る。 各スキーマの名前、説明、最終更新日が表示される。

See a list of your custom schemas

新しいスキーマを作成するには、 Add(Add icon) をクリックし、詳細を入力します。 次に、新しいスキーマの Properties タブをクリックし、含ませたいエンティティを選択する。 Liferayオブジェクト から利用可能な様々なエンティティから選択します。 オブジェクトが オブジェクト関係 を持っている場合、それらのオブジェクトのエンティティも選択できる。

なお、オブジェクトのプロパティ名は必要に応じて変更できる。 例えば、スクリーンショットの student オブジェクトでは、First NameGiven Name に変更する。

Select the entities you want included in your schema.

スキーマを編集または削除するには、 Options(! オプション・アイコン )をクリックし、 Edit または Delete をクリックする。

エンドポイントを理解する

APIエンドポイントは、リクエストを受け付ける特定のURLの場所である。 エンドポイントを管理するには、カスタムAPIアプリケーションの1つをクリックし、 Endpoints タブをクリックしてカスタムエンドポイントのリストを表示します。 各エンドポイントについて、メソッド、URLパス、説明、最終更新が表示される。

新しいエンドポイントを作成するには、 Add(Add icon) をクリックし、詳細を入力します。 エンドポイントは、インスタンスまたはサイトにスコープすることができます。 オブジェクトのスコープに基づいてスコープを選択します。 Configuration_タブをクリックしてエンドポイントを設定します。 エンドポイントで使用するスキーマを選択します。

Select the configuration tab to configure the endpoint.

JSONフィルタリングをエンドポイントに組み込むことができる。 例えば、filter=lastName eq 'Smith'を使用すると、Smithという姓を含むエントリに対してエンドポイントをフィルタリングすることができます。

JSONソートも組み込むことができる。 例えば、sort=firstName:ascを使えば、エントリーをアルファベット順に並べ替えることができる。

フィルタリングとソートの詳細については、 APIクエリパラメータ を参照してください。

エンドポイントを編集または削除するには、 Options(Options icon) をクリックし、 Edit または Delete をクリックします。

次のステップ

Capabilities

Product

Contact Us

Connect

Powered by Liferay
© 2024 Liferay Inc. All Rights Reserved • Privacy Policy