APIヒエラルキーのための戦略

APIエンドポイントのヒエラルキーを構築するために、さまざまなアイデアを適用することができます。

クエリ優先、スキーマをオーバーライド

共通のGraphQLクエリを親に定義し、各アプリケーションに合わせて拡張することができます。

たとえば、親のパーシストクエリ /graphql-query/posts/ は次のGraphQLクエリを定義します。

query GetPosts {
  posts {
    id
    title
    url
  }
}

そして、ウェブサイトとモバイルアプリ向けの子パーシストクエリは、対応するスキーマ設定を指定します。

あるいは、親レベルでスキーマ設定を宣言し、すべての子がそれを継承した上で、GraphQLクエリのみを実装することもできます。

変数を通じて言語コードを指定することで、エンドポイント内のコンテンツを翻訳します。この変数は子エンドポイントでオーバーライドできます。

たとえば、次のGraphQLクエリを使ったパーシストクエリ /graphql-query/posts/ を作成できます。

query GetTranslatedPosts($lang: String!) {
  posts {
    title @strTranslate(from: "en", to: $lang)
    url
  }
}

このエンドポイントを直接実行する必要はないため、無効にしておくことができます。

次に、GraphQL変数をオーバーライドする子パーシストクエリ /graphql-query/posts/french/ を作成します。

{
  "lang": "fr"
}