GraphQL とは？

例えばユーザーの名前だけが必要なら、公開されたuserのnameという項目を選ぶよ。成功した結果はdataの下に要求に沿った形で返る。emailを選ばなければ、その項目は結果に含めない。ただし、公開していない項目を自由に追加して取ることはできないんだ。

スキーマは、要求できる項目やその型を定めるものだよ。要求はその定義に照らして検証される。ただし、誰にどの情報を見せるかという認可は別に実装する。型の定義だけで秘密の情報が保護されるわけではないんだ。

返す内容はそのAPIの設計によるよ。GraphQLではクライアントが項目を選び、関連するデータも一つの要求にまとめられる。だからといって、あらゆるREST APIより転送量や処理時間が小さくなる保証はない。必要な項目と実際の負荷を見て判断するんだ。

別の話だよ。例えばユーザー一覧を一回取得し、各ユーザーの投稿を個別に取得すると、人数Nに対して追加N回のアクセスが起きることがある。これがN+1問題。まとめて取得する設計やDataLoaderなどで対処するが、すべての実装で必ずそのライブラリが必要とは限らないよ。

キャッシュを使う方法や、一覧の件数、要求の深さ・広さ・複雑さを制限する方法を考えるよ。取得項目を減らしても、サーバー内部の負荷が自動的に減るとは限らない。認可や実行時のエラーへの対応も含めてAPIを設計するんだ。