OpenAPI タグの記事

19
投稿
9
著者数
2537
総シェア数
165
Twitter
1
Facebook
1370
はてブ
1001
Pocket

Web API設計ガイドラインを公開しました

Web API に関するガイドラインも昨年11月から検討を開始し、今年の 1/17 に[公開されました！本記事はその紹介になります。

OpenAPIでOAuth認可周りのサーバサイドコード生成を比較

夏といえばコード生成というわけで、HTTP API仕様を定義するOpenAPIの security schemes（認証認可を定義するための箇所）で、Bearer／OAuth2／OpenID Connect 認証を設定すると、各コードジェネレータはどういったコード生成をしてくれるかを調べました。

OpenAPI Specification v3.0.3のコーディング規約を公開しました

フューチャーの有志メンバでOpenAPI Specification（OAS） v3.0.3に対応したコーディング規約を作成しました。

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）のコーディング規約を作りました。

Software Design 2022年8月号執筆記

TIG DX Unitの武田です。先日（2022年7月15日）発売された技術評論社の [Software Design 2022年 8月号] に寄稿させていただきました。まずはじめに、このような寄稿の機会をくださった技術評論社の方々には、心からお礼申し上げます。

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

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

サービス間通信とIDL（インタフェース記述言語）連載を始めます

IDLやエコシステム、サービス間の通信（何かしらのRPC関連の技術）をテーマにした連載を始めます。IDL（インターフェース記述言語: Interface Definition Language）と聞けば...

OpenAPIにおけるundefinedとnullの設計

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

SQLBoiler（とoapi-codegen）でつくるREST APIサーバ

GoのORマッパー連載、折り返して5日目です。SQLBoilerを使用したDBスキーマ駆動なREST APIサーバの開発ワークフローを紹介します。

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` が良いのではと思い、比較調査してみました。結果、実際に選択し導入しています。

1