要点(TL;DR): クエリ文字列、例えば ?include=field_comments.uid を使用すると、field_comments が参照するすべてのエンティティと、それらの エンティティ上の uid が参照するすべてのエンティティをインクルードできます!
JSON:APIでは、レスポンスドキュメント に含めたいリレーションシップパスを指定できるため、HTTPリクエストを削減できます。どのように?
コレクション はリソースの一覧です。デカップルド(分離)サイトでは、クライアント側で「新着コンテンツ」リストや「マイコンテンツ」セクションなどを作成するために使用するものです。
ただし、 /jsonapi/node/article のようなコレクションエンドポイントにフィルターなしでリクエストすると、閲覧を許可されているすべての 記事が返されます。
フィルターがないと、自分の 記事だけや、リャマについての 記事だけを取得することはできません。
このガイドでは、プロのようにフィルターを構築する方法を説明します。
クイックスタート
最もシンプルで一般的なフィルターは、キーと値のフィルターです:
JSON:APIの仕様には多くの概念がありますが、そのすべてがここで文書化されているわけではありません。ただし、モジュールを有効に活用するために、仕様のすべての概念を完全に理解する必要は ありません。JSON:APIのドキュメントがどのように構造化されているか、モジュールがなぜある方法で物事を行うのかなど、より深く知りたい場合や、モジュールの設計についてもっと学びたい場合は、 jsonapi.org の仕様を読むことをお勧めします。
ドキュメントの構造
JSON:APIは、JSONドキュメントをどのように構造化すべきか、すべてのリクエストおよび/またはレスポンスボディにどのような情報を含めなければならないかについて、非常に明確な考え方を持っています。
すべてのリクエスト/レスポンスボディは、単一のJSONオブジェクトの下に置かなければなりません。
モジュールとは、サイトの機能を拡張し、機能を追加するPHP、JavaScript、および/またはCSSファイルのセットです。
モジュールを インストール すると機能や機能をオンにでき、 アンインストール するとオフにできます。アンインストールする前に、その機能に関連するデータと設定を削除する必要がある場合があります。