TypeScript - AppSyncを使って作成したGraphQL APIのドキュメントを設定する最良の方法は何ですか？

私たちは、AWS Lambda を使用して TypeScript で開発を始める API を持っており、それを GraphQL を使って AppSync で世界に公開しています。

私たちはswaggerとtsoaでのドキュメント作成を調べましたが、ラムダの通常のリクエストとレスポンスしか表示されず、S3に保存されます

1. それはラムダに当たることができない
2. これは全くGraphQLであることを示していません
3. まるで寄せ集めで作ったみたいに感じる

もっと良い方法はありますか？

回答 #1

AWS からの公式ドキュメントがあり、ローカルのブラウザでローカルの GraphiQL インスタンスを活用して、ローカルマシンから AppSync GraphQL スキーマを検査しクエリをプロトタイプする方法が記載されています。

リンク: https://aws.amazon.com/blogs/mobile/appsync-graphiql-local

ドキュメントに従うだけで、AppSync の適切なセキュリティを維持することもできます。