カスタムエンドポイント
カスタムスキーマを作成し、異なるユーザーに対してカスタムアクセスルールを設定して、それぞれ専用のエンドポイントで公開できます。
説明
GraphQLサーバーは通常、データの取得と送信のために単一のエンドポイントを公開します。
単一エンドポイントのサポートに加えて、Gato GraphQLではカスタムエンドポイントを作成することも可能です。これにより、以下のようなさまざまなターゲットのニーズに対応するために、異なるスキーマ設定を提供できます。
- 特定のクライアントまたはユーザー
- より多くの機能へのアクセスを持つユーザーグループ（PROユーザーなど）
- モバイルアプリやウェブサイトなど、複数のアプリケーションのうちの1つ
- サードパーティAPI
- その他
カスタムエンドポイントはカスタム投稿タイプ（Custom Post Type）であり、そのパーマリンクがエンドポイントになります。タイトルが "My endpoint"、スラッグが my-endpoint のエンドポイントは、/graphql/my-endpoint/ でアクセスできます。
クライアント
各カスタムエンドポイントには、操作するための専用クライアントセットがあります。
✅ GraphiQLクライアント：エンドポイント + ?view=graphiql でアクセス可能（例：/graphql/my-endpoint/?view=graphiql）。
モジュール GraphiQL for Custom Endpoints を有効にする必要があります。
✅ インタラクティブスキーマクライアント：エンドポイント + ?view=schema でアクセス可能（例：/graphql/my-endpoint/?view=schema）。
モジュール Interactive Schema for Custom Endpoints を有効にする必要があります。
カスタムエンドポイントの作成
メニューの「カスタムエンドポイント」リンクをクリックすると、作成済みのすべてのカスタムエンドポイントの一覧が表示されます。
カスタムエンドポイントはカスタム投稿タイプ（CPT）です。新しいカスタムエンドポイントを作成するには、「新しいGraphQLエンドポイントを追加」ボタンをクリックすると、WordPressエディターが開きます。
カスタムエンドポイントの準備ができたら公開すると、そのパーマリンクがエンドポイントのURLになります。エンドポイント（およびソースとクライアント）へのリンクは、「カスタムエンドポイントの概要」サイドバーパネルに表示されます。
パーマリンクに ?view=source を付加すると、エンドポイントの設定が表示されます（ユーザーがログインしており、そのユーザーロールがアクセス権を持っている場合に限ります）。
デフォルトでは、カスタムエンドポイントのパスは /graphql/ であり、この値は設定画面から変更できます。
スキーマ設定
スキーマに含まれる要素と、ユーザーがスキーマにアクセスできる範囲は、スキーマ設定で定義されます。
そのため、スキーマ設定を作成し、ドロップダウンから選択する必要があります。
カスタムエンドポイントのカテゴリー分類
サイドバーパネルの「エンドポイントカテゴリー」で、カスタムエンドポイントの管理に役立つカテゴリーを追加できます。
たとえば、クライアント、アプリケーション、またはその他の必要な情報でエンドポイントを管理するカテゴリーを作成できます。
カスタムエンドポイントの一覧では、それぞれのカテゴリーを確認でき、カテゴリーリンクをクリックするか、上部のフィルターを使用すると、そのカテゴリーのエントリーのみが表示されます。
プライベートエンドポイント
カスタムエンドポイントのステータスを private に設定すると、そのエンドポイントは管理者ユーザーのみがアクセスできるようになります。これにより、アクセス権を持つべきでないユーザーにデータが意図せず共有されることを防ぎます。
たとえば、メトリクスでレポートを作成するためのデータ取得など、アプリケーション管理に役立つプライベートなカスタムエンドポイントを作成できます。
パスワード保護されたエンドポイント
特定のクライアント向けにカスタムエンドポイントを作成する場合、パスワードを割り当てることができます。これにより、そのクライアントのみがエンドポイントにアクセスできるという追加のセキュリティレベルを提供します。
パスワード保護されたエンドポイントに初めてアクセスする際（エンドポイントに直接アクセスする場合、またはそのGraphiQLやInteractive Schemaクライアントにアクセスする場合）、パスワードを求める画面が表示されます。
パスワードが入力・検証されると、初めてユーザーは目的のエンドポイントまたはクライアントにアクセスできます。
