OpenAPI

新着順 人気順

orvalでOpenAPIからReact Queryフックを自動生成する

orvalでOpenAPIからReact Queryフックを自動生成する はじめに OpenAPIで定義したAPIをReactから呼び出すとき、useQuery や useMutation を毎回手書きしていませんか? orval を使うとOpenAPI仕様からTypeScriptの型定義・React Queryフック・APIクライアン…

OpenAPIからTypeScript型定義とfetchクライアントを自動生成する:openapi-typescript + openapi-fetch

OpenAPIからTypeScript型定義とfetchクライアントを自動生成する:openapi-typescript + openapi-fetch はじめに OpenAPIでAPI仕様を定義したあと、TypeScript側で同じ型を手書きしていませんか? openapi-typescript を使うとOpenAPI仕様ファイルからTypeSc…

OpenAPIスキーマ設定チートシート:nullable・enum・共通化まで

OpenAPIスキーマ設定チートシート:nullable・enum・共通化まで はじめに OpenAPIでAPI仕様を書いていると「nullを許可したい」「選択肢を限定したい」「404レスポンスを毎回書くのが面倒」といった場面によく出会います。 この記事ではスキーマの主要な設定…

OpenAPI入門:YAML仕様の書き方からSwagger UIで確認するまで

OpenAPI入門:YAML仕様の書き方からSwagger UIで確認するまで はじめに APIを開発するとき、仕様をどうやって共有していますか?MarkdownでAPIドキュメントを書いてもすぐ古くなる、口頭で説明してすれ違いが起きる、といったことがよくあります。 OpenAPIは…