Future Tech Blog
フューチャー技術ブログ

Swagger タグの記事

  • 14
    投稿
  • 8
    著者数
  • 2126
    総シェア数
  • 155
    Twitter
  • 0
    Facebook
  • 1074
    はてブ
  • 897
    Pocket

OpenAPI 3.0.3 と 3.1.0 どっち使う？

Swaggerを使う事になり OpenAPIを触ってみると 3.0.3 と 3.1.0 が存在します。どちらを使うべきが悩んだので調べて整理してみました。

フューチャーのSwagger（OpenAPI 2.0）規約の紹介

フューチャーの有志メンバーでSwagger（OpenAPI Specification Version 2.0）のコーディング規約を作りました。

OpenAPI GeneratorでPython Web API構築

PythonでWebAPIを構築しました。その際にOpenAPI Generatorが便利だったのでご共有します。

Open API Specification 3.1と気になる仕様策定

Open APIは2022.6.21時点では3.1.0が最新です。これまでリリースノートすらウォッチしていなかったので気になったことを調べてまとめました。

OpenAPIにおけるundefinedとnullの設計

OpenAPI仕様に則ってREST APIの設計をする際に、値が存在しないという状態をどのように表現するかというお話です。まずはじめに、ここで`undefined`と言っているのは、OpenAPIの仕様において、リクエスト/レスポンスのデータ型を定義するSchema Objectのプロパティの1つである`required`が指定されていない状態を指します。

Flutter Swagger統合

Dart/Flutter連載の2記事目です。はじめまして、TIGの宮崎将太です。突然ですがみなさん、Swagger使いたいですよね。

GoにおけるAPIドキュメントベースのWeb API開発について登壇しました

TIG 多賀です。2021/3/19 を開催しました。 私は、Goの Web API 開発にて、API ドキュメントベースで開発していることについて話しました。なお、その他の登壇者の資料は [こちら] に公開済みですので、興味があれば参照ください。

OpenAPIからモックサーバを建てられるPrismを実際のプロジェクトに導入してみた

参加しているプロジェクトで、OpenAPI定義ファイルからモックサーバを建てることができるOSSツール「Prism」を導入することになりました。この記事では、Prism導入の手順や、躓いた点などを紹介します。

Policy as Code を実現する Open Policy Agent に憧れて。ポリシーコードでAPI仕様をLintする

Open Policy Agent（OPA）は汎用的なポリシーエンジンで、[Rego] と呼ばれるポリシー言語で定義されたルールに従って、入力がポリシーに沿っているか否かの判定を移譲させることができます。Regoで宣言的にポリシーを実装し、Policy as Code を実現できます。コーディング規約も一種のポリシーとみなして、Open API Spec（Swagger）をLinter的にチェックするツールを題材に、OPAを用いて開発してみたいと思います。

Go の Open API 3.0 のジェネレータ oapi-codegen を試してみた

go-swagger は Swagger 2.0 にのみ対応しており、OpenAPI 3.0 系が使えない問題がありました。最新に追従していく上でも Open API 3.0 系に寄せていきたいと考えていたので、なにか使えるツールはないか探したところ、以下を見つけました。 https://github.com/deepmap/oapi-codegen 使えるかどうか実際に動かして試してみます。

go-swaggerを用いたWebアプリケーション開発Tips19選

業務でヘビーユーズしているgo-swaggerについての開発Tipsをまとめました。

スキーマファースト開発のためのOpenAPI（Swagger）設計規約

みなさん、Swagger使ってますか？本記事では実際にSwaggerのスキーマ定義を設計していく上で取り決めた規約について書いてみたいと思います。

本当に使ってよかったOpenAPI (Swagger) ツール

みなさんSwagger使ってますか？弊社でもREST APIを構築するに当たってSwaggerを導入する機会が増えています。本記事ではSwaggerを導入するに当たって、合わせて利用して便利だったツールを紹介したいと思います。

WAFとして go-swagger を選択してみた

Go のWebアプリケーションフレームワークを検討した際に、 `go-swagger` が良いのではと思い、比較調査してみました。 結果、実際に選択し導入しています。