Swagger+JSON SchemaでAPIの型をテストして開発サイクルをスピードアップさせた話 - pixiv inside
CTO兼福岡オフィス立ち上げ担当として新アプリを作っている@edvakfです。 JSON APIを開発しているとこういう問題がありがちですよね。 仕様どおりにAPIの形式を作ったはずだけどなんか自信が持てない テストでいくつかのキーが存在するかの簡単なチェックはしてるつもりだけど、全部チェックするのは大変すぎる APIのControllerやViewをリファクタリングしたらレスポンスの形が変わってアプリがめっちゃクラッシュし始めた というのが怖くて誰もリファクタリングできなくなった APIドキュメントがメンテされない 知らない間にレスポンスのフィールドが増えてたけどドキュメントに書いてない これらを解決したい！と思って試行錯誤したら、スマートに解決することができました。この記事ではRailsのことについて書きますが、考え方は他の言語・フレームワークでも同じです。 なお、今回使ったgemのバ
前夜祭トーク：SiriKit and Me、Swaggerで始めるAPI定義管理とコードジェネレート | gihyo.jp
iOSDC Japan 2017 カンファレンスレポート 前夜祭トーク：SiriKit and Me、Swaggerで始めるAPI定義管理とコードジェネレート iOSDC Japan 2017とは？ iOSDC Japan 2017はエンジニアが主役の、iOSと周辺技術を題材としたカンファレンスです。昨年初開催のiOSDC Japan 2016に続き、今年が2回目の開催となりました。 今年はiOSDC Japan 2017 実行委員会とWASEDA-EDGE人事育成プログラム実行委員会の主催のもと、早稲田大学 理工学部西早稲田キャンパス 63号館で、9月15日〜17日の2.5日間（15日は夕方から開催の前夜祭）にわたり開催されました。 昨年と比較すると、開催日数は前夜祭を含め1.5日から2.5日、トーク応募数は168から282、スピーカー数は42人から91人、参加者は478人から742人と
開発効率を上げる！Swaggerで作るWEB APIモック - ZOZO TECH BLOG
こんにちは。バックエンドエンジニアのじょーです。 みなさんは、開発初期の段階でWeb API（以下API）の実装が追いつかずクライアント側が開発できないという経験をしたことはありますか？ クライアント側はAPIがないと開発が滞ってしまうことがありますが、かといってAPIの開発も始まったばかりではすぐに必要なAPIを提供することができません。その問題を解決し、両者でスムーズに開発をすすめるために有効な方法の1つに、APIモックの作成があります。 弊社では、開発初期の段階でWeb APIのモックを作成し、スムーズに開発できるようにしています。 以前は、Apiaryをモック作成ツールとして利用していましたが、記法やエディターに使いづらい点があり最近Swaggerに移行しました。 本記事では、Swaggerを使ったAPIモックの作成方法と手順、また気をつけるべき点などを紹介します。 目次 Swag
開発効率を上げる！Swaggerで作るWEB APIモック - Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? みなさんは、開発初期の段階でWeb API(以下API)の実装が追いつかずクライアント側が開発できないという経験をしたことはありますか？ クライアント側はAPIがないと開発が滞ってしまうことがありますが、かといってAPIの開発も始まったばかりではすぐに必要なAPIを提供することができません。その問題を解決し、両者でスムーズに開発をすすめるために有効な方法の1つに、APIモックの作成があります。 弊社では、開発初期の段階でSwaggerとその周辺ツールを使ってWeb APIのモックを作成し、スムーズに開発できるようにしています。 Swag
�Swagger Editorで作成したファイルを�Swagger UIで見てみる - Qiita
Swaggerとは RESTful APIの記述標準化を目指して「Open API Initiative」 が作成した記述仕様のこと。 ドキュメント周辺が更新されないまま実装とずれていったりするのをしばしば見るので最近ちょくちょく触っている。 Swaggerで主に使用するツール 1.Swagger Editor ・Swaggerの仕様にしたがってYAML(JSON)ファイルを編集するツール 2.Swagger UI ・YAML(JSON)ファイルのビュワー 3.Swagger Core ・YAML(JSON)からソースコードを作成するツール 4.Swagger Codegen ・ソースコードからYAML(JSON)ファイルを作成するツール 今回はSwagger Editorで作成したYAML(JSON)ファイルをSwagger UIで見るところまでやる。 Swaggerのフォーマット 実際
待望のOpenAPI Spec 3.0が7月にリリース
あなたにとって重要なトピックや同僚の最新情報を入手しましょう最新の洞察とトレンドに関する最新情報を即座に受け取りましょう。 継続的な学習のために、無料のリソースに手軽にアクセスしましょうミニブック、トランスクリプト付き動画、およびトレーニング教材。 記事を保存して、いつでも読むことができます記事をブックマークして、準備ができたらいつでも読めます。
AutoRest - OpenAPI Specificationから各種プログラミング言語向けSDKを生成
OpenAPI Specification（旧Swagger）の定義ファイルはドキュメントを生成するのによく使われます。しかし、それだけではなく他にも様々な使い道があります。例えばテストやバリデーションです。 さらにAutoRestを使えば各種プログラミング言語向けにSDKを生成してくれます。これは見逃せない機能でしょう。 AutoRestの使い方 実行例です。C#のコードを生成しました。 さらに指定を追加するだけでRubyのコードも生成できます。 AutoRestが対応するのはC#、Go、Java、node、TypeScript、Python、RubyそしてPHPとなっています。これだけのプログラミング言語に対応していればまずは問題ないでしょう（Swiftも欲しいですが）。SwaggerCodegenという類似プロジェクトもありますが、AutoRestはOpenAPI Specifica
Swagger Is Now The OpenAPI Specification | Build5Nines
A while back I wrote an OSS Spotlight post about the Swagger project. In short, Swagger is “the world’s most popular API tooling”. It’s a powerful open source framework backed by a very large ecosystem of tools that help you design, build, document, and consume your RESTful APIs. The Swagger v3.0 Specification was contributed to the OpenAPI Initiative, and thus Swagger has been merged with OpenAPI
Rails + swagger-blocks で OpenAPI 形式の API ドキュメントを作成する
{ "swagger": "2.0", "info": { "version": "1.0.0", "title": "Sample App", "description": "This is a sample app.", "contact": { "name": "@kymmt90" }, "license": { "name": "MIT" } }, // ... "paths": { "/users": { "post": { "description": "Creates a user", "operationId": "create_user", "parameters": [ { "$ref": "#/parameters/user" } ], "responses": { "201": { "description": "Created user", "schema": {
Swaggerで定義したAPIドキュメントとAPIレスポンスの差異をなくす - Qiita
# pet.yaml swagger: "2.0" info: description: "これはペットストアに関するAPIです。" version: "1.0.0" title: "Petstore API" termsOfService: "http://swagger.io/terms/" contact: email: "apiteam@swagger.io" license: name: "Apache 2.0" url: "http://www.apache.org/licenses/LICENSE-2.0.html" produces: - "application/json" consumes: - application/x-www-form-urlencoded paths: /pets/{petId}: get: summary: "ペット情報API" descrip
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - Maks3w/SwaggerAssertions: Assert your API requests and responses match with your swagger definition
プライベートAPIのクライアントをいい感じにしたい / pepabo_ec_tech_mtg02
DapperDox – Beautiful, integrated, OpenAPI documentation
GitHub - Swagger2Markup/swagger2markup: A Swagger to AsciiDoc or Markdown converter to simplify the generation of an up-to-date RESTful API documentation by combining documentation that’s been hand-written with auto-generated API documentation.
GitHub - fotinakis/swagger-blocks: Define and serve live-updating Swagger JSON for Ruby apps.
Swaggerで始めるAPI定義管理とコードジェネレート - Qiita
Swagger Codegenで APIクライアントgem 自動生成 #m3kt
GitHub - sourcey/spectacle: Beautiful static documentation generator for OpenAPI/Swagger 2.0
Swagger UI
Optional path parameters · Issue #93 · OAI/OpenAPI-Specification
