Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
swagger editor を趣味で活かす
Search
kanayannet
February 02, 2019
Programming
0
340
swagger editor を趣味で活かす
kanayannet
February 02, 2019
Tweet
Share
More Decks by kanayannet
See All by kanayannet
TDDと今まで
kanayannet
0
200
個人開発 稼げなくてもいいアプリ
kanayannet
0
320
システムの堅牢性
kanayannet
0
160
Agile的学習方法
kanayannet
0
180
GUIをエンジニアが考える
kanayannet
0
150
http2http3
kanayannet
0
130
old typeからのクラウドインフラ
kanayannet
0
280
疎結合と認知
kanayannet
0
300
クリーンアーキテクチャを活かす考察
kanayannet
1
180
Other Decks in Programming
See All in Programming
WebGLで始める コンピュータグラフィックス入門
heller77
0
330
禅の心を手に入れよ
eltociear
1
420
『Railsオワコン』と言われる時代に、なぜブルーモ証券はRailsを選ぶのか
free_world21
1
400
DMMプラットフォームがTiDB Cloudを採用した背景
pospome
9
4.3k
Balkan Ruby 2024 — How and why to run SQLite on Rails in production
fractaledmind
0
100
PHPはいつから死んでいるかの調査
chiroruxx
2
420
Sheets API使ってみた
toshi0383
2
170
MetricKitで予期せぬ終了を検知する話 / Detect unexpected termination with MetricKit
nekowen
1
200
Elm 0.19.0 Changes
bkuhlmann
0
510
Site Reliability Engineering for GMO
pyama86
9
1.1k
Node.js v22 で変わること
yosuke_furukawa
PRO
12
4k
Ruby Pattern Matching
bkuhlmann
0
930
Featured
See All Featured
Web development in the modern age
philhawksworth
203
10k
Building a Modern Day E-commerce SEO Strategy
aleyda
22
6.4k
Infographics Made Easy
chrislema
238
18k
Save Time (by Creating Custom Rails Generators)
garrettdimon
PRO
0
36
5 minutes of I Can Smell Your CMS
philhawksworth
199
19k
Designing for Performance
lara
601
67k
GraphQLとの向き合い方2022年版
quramy
33
12k
Navigating Team Friction
lara
179
13k
Mobile First: as difficult as doing things right
swwweet
217
8.6k
Typedesign – Prime Four
hannesfritz
36
2.1k
Clear Off the Table
cherdarchuk
85
310k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
14
1.5k
Transcript
Swagger Editor を趣味で活かす @kanayannet Gunma.web #34
What's Swagger Editor
Design, describe, and document your API on the first open
source editor fully dedicated to OpenAPI‑based APIs. The Swagger Editor is great for quickly getting started with the OpenAPI
OpenAPI専用の最初のオープンソースエディ タでAPIを設計、記述、文書化します。 Swagger Editorは、OpenAPIをすぐに使い始 めるのに最適です。
大事なことなので OpenAPIをすぐに使い始めるのに 最適です。
どうせやるなら日常生活の何かで試したい
部屋の温度のAPI
理由 2月に子供生まれます。
理由 2月に子供生まれます。 部屋が寒すぎたり、暑すぎたりが怖い。
理由 2月に子供生まれます。 部屋が寒すぎたり、暑すぎたりが怖い。 出先でも知りたい。
システム構成 ラズパイで温度を API へ post
None
システム構成 ラズパイで温度を API へ post API ‑> DB に部屋ごとにデータを書く
システム構成 ラズパイで部屋ごとの温度を API へ post API ‑> DB に部屋ごとにデータを書く 出先で端末からAPIへアクセスして部屋ごとの温度を得る
図
デモ
注意点(自分がハマったもの) docker 経由で使ったものは default https だった。 schemes: で指定すれば解決 docker 以外でもそうかも?(未検証)
type: array の後ろは items items というキーのarray ではない。 POST の場合 name=xxxx のものは 引数の定義があっても右のシュミレータ で正しく値を渡してくれない場合がある。 必要な設定 in: formData consumes: application/x‑www‑form‑urlencoded
まとめ 今まで フレームワークによってフォーマットが決まってないルーティ ングが存在する 該当のフレームワークのルーティングを読めないと不安。 例: rails: config/route.rb など swagger
editor後 yaml という人間にやさしい定義書で見れそう。 先行して client の作成を始めやすいか。
ご清聴ありがとうございました!
質疑応答