Rails + swagger-blocks で OpenAPI 形式の API ドキュメントを作成する
この記事では、Rails で書いた JSON API サーバそれ自体の API エンドポイント仕様ドキュメントを OpenAPI 形式の JSON データとして生成し、そのデータを 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": "c
Grape+SwaggerでAPIのドキュメント作成を自動化した - 弥生開発者ブログ
こんにちは、Misoca開発チームのいっしーです。 11月からMisocaにJoinしました。 10年ほど東京にいたので、未知の土地に新鮮な気持ちでいます。 名古屋の好きなところはB級グルメがたくさんあるところ、こわいところは学生時代に学んでいた関数型言語OCamlや自然言語の形式理論の話がナチュラルに通じてしまうところです。 さて、そんな私の初仕事であるMisoca API v3が先日リリースされました。 見積書や取引先をAPI経由で扱えるようになっています。 www.misoca.jp また、技術面ではGrapeとgrape-swaggerを新たに導入しました。 今回はこれらについて紹介したいと思います。 背景 Misoca API v1 (以後、v1とします) では、Rails標準のControllerでリクエストを受け付け、結果をjson形式などでレスポンスを返す形を取っていました
Swaggerで始めるAPI定義管理とコードジェネレート
iOSDC 2017 2017/09/15@早稲田大学理工学部西早稲田キャンパス 63号館 Yohei Suginami ( @susieyy )
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
