本当に使ってよかったOpenAPI (Swagger) ツール | フューチャー技術ブログ
サードパーティ製のツール本家からは上述のツールが提供されていますが、サードバーティ製の様々なツールが世の中には存在します。 エコシステムが成熟しているのもSwaggerを利用するメリットの一つですね。 https://openapi.tools/ 冒頭のとおり、このサードパーティ製のツールの中で実際に利用して良かったツールを3つご紹介したいと思います。 Stoplight Studiohttps://stoplight.io/studio/ 1つ目のツールは「Stoplight Studio」というAPI仕様を記載するためのGUIエディタとなります。 今までSwagger Editorを利用してYAMLを書いていたそこのみなさん、YAML筋力はもう必要ありません。 Design APIs 10x faster の謳い文句どおり、Stoplight Studioを使えばGUIで直感的に、高速
AWS CDK で API Gateway + Swaggerの環境を構築する | DevelopersIO
おはようございます。CX事業本部＠札幌の佐藤です。 はじめに AWS CDKではAPI Gatewayを作成する方法として、以下の3種類の方法があります。 @aws-cdk/aws-apigatewayの RestAPI を使う（基本はこれ） @aws-cdk/aws-apigatewayの CfnXXXX を使う（冗長な記述になる） @aws-cdk/aws-samの CfnApi を使う（AWS SAMのAWS::Serverless::Apiと同じ） 概要 AWS CDKを使ってサーバーレスなRestAPIのインフラを構築することになりました。AWS SAMだと、AWS::Serverless::Apiを使えば、Swaggerに対応しているんですが、AWS CDKでは以下のIssueにある通り、現状API GatewayのSwaggerが対応されていません。（対応予定ではあります）
Swaggerで始めるAPI定義管理とコードジェネレート
iOSDC 2017 2017/09/15@早稲田大学理工学部西早稲田キャンパス 63号館 Yohei Suginami ( @susieyy )
Swagger+JSON SchemaでAPIの型をテストして開発サイクルをスピードアップさせた話 - pixiv inside
CTO兼福岡オフィス立ち上げ担当として新アプリを作っている@edvakfです。 JSON APIを開発しているとこういう問題がありがちですよね。 仕様どおりにAPIの形式を作ったはずだけどなんか自信が持てない テストでいくつかのキーが存在するかの簡単なチェックはしてるつもりだけど、全部チェックするのは大変すぎる APIのControllerやViewをリファクタリングしたらレスポンスの形が変わってアプリがめっちゃクラッシュし始めた というのが怖くて誰もリファクタリングできなくなった APIドキュメントがメンテされない 知らない間にレスポンスのフィールドが増えてたけどドキュメントに書いてない これらを解決したい！と思って試行錯誤したら、スマートに解決することができました。この記事ではRailsのことについて書きますが、考え方は他の言語・フレームワークでも同じです。 なお、今回使ったgemのバ
OpenAPI Specification と Swagger Godegen に至るまで辿った道。CORBA, RMI, SOAP, Thrift, gRPC, REST, WADL, OpenAPI Specification などの話 - よしなしごと
ポエムです。コードが1行も出てこないので じっちゃん に怒られそうです。 Remote Procedure Call(RPC)に長年興味を持ち、実案件で使ってきました。 RPC は、ネットワーク上にあるロジックを関数呼び出しで実行することができ、通信のためのコードを隠蔽する技術と考えています。 RPCに関し、OpenAPI Specification(Swagger Codegen)に辿り着くまでの道を振り返ってみました。 CORBA www.corba.org Common Object Request Broker Architecture 様々なプログラミング言語で書かれたソフトウェアコンポーネントの相互利用を可能にするもの（分散オブジェクト技術） サポートされる異言語間の通信が可能 IIOP というプロトコルを使っている CORBA の歴史は長いみたいですが、私が実案件で使ったのは
SwaggerでRESTful APIの管理を楽にする - Qiita
背景 最近は変化し続ける要件に対応するために、システムも柔軟であることが求められています。 そのため、部分的に変更やスケールの可能なシステムを構築し、API経由で連携するマイクロサービス的アーキテクチャが増えてきています。 そういった設計の中で問題になっていくのが、従来のモノリシックなアプリケーションではIDEやコンパイラなどで行っていた、機能間のインターフェイスをどう管理するかという部分です。 Swaggerとは? SwaggerとはRESTful APIのドキュメントや、サーバ、クライアントコード、エディタ、またそれらを扱うための仕様などを提供するフレームワークです。 公式サイトでは、The World's Most Popular Framework for APIsと謳っています。 その理由は、マイクロソフト、Google、IBM、SmartBearなどを大手の企業を含む「Open
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
