OpenAPI: 3.1 で仕様を書いて Swagger UI で読む
REST API 設計・実装ガイドの第11章。08〜10 章で決めたエンドポイント・表現・誤りの応答を、OpenAPI 3.1 の仕様に書きます。文書の構造、操作と operationId、パラメータとリクエストの本文、JSON Schema 2020-12 のスキーマ、$ref と components、例と問題の詳細の書き方を、選んだ理由と一緒に示します。仕様が設計の文書と食い違わないことをテストで確かめ、書いた仕様を Swagger UI で読みます。