最近、個人でAPI開発を行う際に `swagger × zodスキーマ` を使ってAPIのドキュメントを作ることが多いです。 そこで、最近良く使用する `zod-to-openapi` を使ったドキュメント構築例と、おまけで汎用的なバリデーションエラーの実装例を共有します。 使用技術 ...

こんにちは！フィフス・フロアの開発チームリーダーのnotozekiです。 最近、OpenAPIという技術を知りました。OpenAPIは、いわゆる「Web API」の仕様を形式的に記述するためのフォーマットです。OpenAPIに関連するツールもいくつか提供されており、たとえばOpenAPI ...

「実践！フロントエンド分離戦略」はREADYFOR 株式会社主催のエンジニア向けLT勉強会です。ここで、菅原氏が「OpenAPI GeneratorとTypeScriptによる型安全なスキーマ駆動開発」のタイトルで登壇。スキーマ駆動開発とそのメリット、活用しているツールについて ...

さきほど、「Swagger 3.0(OAS:Open API Specification 3.0)」と書きましたが、実は今回の3.0へのバージョンアップより、Swaggerは位置付けが変わっています。まずはその点を説明しておきましょう。 Smarter Bear社のSwaggerは2015年12月31日に、マイクロソフトやグーグルなどに ...

システム開発のトレンドとして、マイクロサービス化が進んできています。モノリス(一枚岩)スタイルの開発に比べて、アプリケーションの単位は小さくなり、多くのサービスが構築されます。 Uberの配車ビジネスやAirbnbの民泊に代表されるデジタルビジネス ...