Swagger

OpenAPI Generatorに適したOpenAPIの書き方

はじめに こんにちは! WEARバックエンドブロックの高久です。 WEARではOpenAPI(Swagger)を使って、アプリやWebのクライアントが利用するAPIを定義しています。そして先日、開発効率化のためにOpenAPI GeneratorでOpenAPIからAPIクライアントコードを自動…

OpenAPI Generatorのコード生成とSpring Frameworkのカスタムデータバインディングを共存させる

OpenAPI Generatorを使ったOpenAPI定義からのコード生成と、Spring Frameworkのカスタムデータバインディングを共存させるために実施したことをご紹介します。

Go言語におけるOpenAPIを使ったレスポンス検証

本記事では、Go言語におけるOpenAPIを使ったレスポンス検証について紹介します。具体的には、kin-openapiパッケージを使ったテスト方法と、OpenAPIの表現力では足りないレスポンス表現についての拡張とそれに対応した検証方法を紹介します。

OpenAPI3を使ってみよう!Go言語でクライアントとスタブの自動生成まで!

はじめに こんにちは! 2019年2月にZOZOテクノロジーズへサーバーサイドエンジニアとして入社した籏野(@gold_kou)と申します。 Qiitaでも少し記事書いてます。 いきなりですが、皆さんはAPI仕様書をどのように管理されていらっしゃいますか? Confluence、…

OpenAPIのschema定義からRubyのクラスを生成するgem「openapi2ruby」をつくりました

こんにちは。スタートトゥデイテクノロジーズ新事業創造部のid:takanamitoです。 今日はVASILY時代から活用されているOpenAPI(Swagger)の定義からRubyのクラスを自動生成するgemを作ったので、その紹介をしようと思います。 Swaggerの定義と実際のAPIが返す…

開発効率を上げる!Swaggerの記法まとめ

この記事ではOpenAPI Specification v2に関する内容を取り上げています。しかし、2023年9月現在での最新の仕様はOpenAPI Specification v3となっています。最新の仕様に基づいて実装や学習を行いたい方は、公式ドキュメントやそれに関連する資料をご参照くだ…

開発効率を上げる!Swaggerで作るWEB APIモック

こんにちは。バックエンドエンジニアのじょーです。 みなさんは、開発初期の段階でWeb API(以下API)の実装が追いつかずクライアント側が開発できないという経験をしたことはありますか? クライアント側はAPIがないと開発が滞ってしまうことがありますが、…

カテゴリー