Adding Examples | Swagger
OAS 3 This guide is for OpenAPI 3.0. If you use OpenAPI 2.0, see our OpenAPI 2.0 guide. You can add examples to parameters, properties and objects to make OpenAPI specification of your web service clearer. Examples can be read by tools and libraries that process your API in some way. For example, an API mocking tool can use sample values to generate mock requests. You can specify examples for obje
A Visual Guide to What's New in Swagger 3.0
Over the past few years, Swagger 2 has become the de facto standard for defining or documenting your API. Since then, it's been moved to the Linux foundation and renamed to OpenAPI Spec. Version 3 has been in the works for a while, and it's finally feature complete! Here's a guide to what's changed, and how to upgrade from Swagger 2 to OpenAPI 3. Like Swagger? ReadMe just launched support for Swag
Swaggerを利用した新規サービス開発
1. © Recochoku Co.,Ltd. Proprietary and Confidential 2017/02/07 Swaggerを利用した 新規サービス開発 株式会社レコチョク 事業システム推進部 ミュージックアーキテクトグループ 松木 佑徒 2. © Recochoku Co.,Ltd. Proprietary and Confidential 2017/02/07 自己紹介 2 職業：フルスタックエンジニア(自称) 言語：C# (2008~2010) -> Java (2011~2015) -> Python (2016~) 趣味：ドラム / ジャグリング Yuto Matsuki @yustam_jp id:yustam 2008: 某SIerにてシステムエンジニアとして色々な現場で仕事をする 2014: 株式会社レコチョクに転職 2014-2015: レコチョクの楽曲DB
Laravelでartisan使ってSwagger.jsonを出力する - Qiita
<?php namespace App\Console\Commands; use Illuminate\Console\Command; class SwaggerOutput extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'swagger:output'; /** * The console command description. * * @var string */ protected $description = 'vendor/bin/swagger app -o public/swagger を実行する'; /** * swagger output * * @return mixed */ publ
Swagger-PHPについてLaravel 5.2で確認したメモ – hrendoh's tech memo
SwaggerのPHP実装であるSwagger-PHPの使い方についてLaravelプロジェクトで確認し、Swaggerとはどんなものか調査したメモになります。 Swaggerの全体像については、「RESTful APIの記述標準化を担うSwaggerとは？ | NTT Communications Developer Portal」が参考になりました。 Swaggerを利用したアプリケーション開発は、まずSwaggerドキュメントを作成して、サーバーのスタブとクライアントライブラリを生成し、APIロジックとクライアントUIなどを実装していくような流れになるといったところのようです。 Laravelはありませんが、コード生成ツール swagger-codegen には、Laravelの軽量版であるLumen用のサーバースタブは生成可能です。 この記事では、Laravel 5.2プロジェクト
LaravelプロジェクトのAPIをswaggerを使ってドキュメント化 - Qiita
APIのドキュメント、書くのたいへんですよね。 作っても放置されて更新されず誰も読まなくなったなんてこともあると思います。 今回はswaggerを使って、ドキュメントの生成を楽にしてみました。 swaggerとは swaggerとはAPIドキュメント生成ツールです。 http://swagger.io/ コード内に特定の記述でコメントを含めておくと、コマンド実行でAPIドキュメントを生成してくれます。 今回の環境 多くので言語でライブラリが用意されていますが、 今回はphpのLaravelフレームワークでの使い方を紹介します。 php composer Laravel4 or 5 使い方 インストール まずcomposerで必要ライブラリをインストールします。 Laravelプロジェクトのルート・ディレクトリで実行。
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Laravel OpenAPI 3 Documentation Verification Using Dredd
GitHub - fotinakis/swagger-blocks: Define and serve live-updating Swagger JSON for Ruby apps.
GitHub - Redocly/redoc: 📘 OpenAPI/Swagger-generated API Reference Documentation
GitHub - swaggo/gin-swagger: gin middleware to automatically generate RESTful API documentation with Swagger 2.0.