TypeScript のような構文で OpenAPI のスキーマを定義する TypeSpec

TypeSpecは、TypeScriptに似た直感的で簡潔な構文を用いて、OpenAPIスキーマを定義するための言語です。複雑になりがちなYAMLやJSONでのOpenAPI記述の課題を解決し、API定義の可読性と保守性を大幅に向上させることを目指しています。@getや@postなどのデコレーターを活用し、HTTPメソッドやパス、リクエスト/レスポンス構造を直接的に記述できるのが特徴です。定義されたTypeSpecコードからはOpenAPI 3.xやJSON Schemaなどの形式を生成でき、Microsoftによって開発されています。

• •TypeScriptライクな構文でOpenAPIスキーマを定義でき、従来の記述方法よりも高い可読性と簡潔性を提供します。
• •APIのHTTP操作（GET, POSTなど）やパス、リクエスト/レスポンス構造をデコレーターを用いて直接記述できます。
• •TypeSpecコードからOpenAPI 3.xやJSON Schemaを生成可能で、複雑なAPI定義のメンテナンス問題を解決します。