Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Speaker Deck
PRO
Sign in
Sign up for free
swagger editor を趣味で活かす
kanayannet
February 02, 2019
Programming
0
290
swagger editor を趣味で活かす
kanayannet
February 02, 2019
Tweet
Share
More Decks by kanayannet
See All by kanayannet
old typeからのクラウドインフラ
kanayannet
0
54
疎結合と認知
kanayannet
0
89
クリーンアーキテクチャを活かす考察
kanayannet
1
87
プロジェクト管理ツールの経験則
kanayannet
0
150
TDDと認知
kanayannet
0
160
gunmaweb-serverless
kanayannet
0
120
Animation GIF
kanayannet
0
200
今更聞けないPWA
kanayannet
0
390
jojo-naive
kanayannet
0
170
Other Decks in Programming
See All in Programming
Imperative is dead, long live Declarative! | Appdevcon
prof18
0
110
Improving Developer Experience Through Tools and Techniques 2022
krzysztofzablocki
0
1.2k
I/O Extended 2022 in Android ~ Whats new in Android development tools
pluu
0
560
[월간 데이터리안 세미나 6월] 스스로 성장하는 분석가 커리어 이야기
datarian
0
240
こそこそアジャイル導入しようぜ!
ichimichi
0
1.2k
GDG Seoul IO Extended 2022 - Android Compose
taehwandev
0
330
Web API連携でCSRF対策がどう実装されてるか調べた / how to implements csrf-detection on Web API
yasuakiomokawa
2
480
Vite でお手軽 Vue.js の環境構築
azuki
2
190
Jetpack Composeでの画面遷移
iwata_n
0
190
設計ナイト2022 トランザクションスクリプト
shinpeim
11
2.1k
チームでカレーを作ろう!アジャイルカレークッキング
akitotsukahara
0
870
UI Testing of Jetpack Compose Apps, AppDevCon
alexzhukovich
0
170
Featured
See All Featured
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
237
19k
What's in a price? How to price your products and services
michaelherold
229
9.4k
Web Components: a chance to create the future
zenorocha
303
40k
Build The Right Thing And Hit Your Dates
maggiecrowley
19
1.2k
How to Ace a Technical Interview
jacobian
265
21k
KATA
mclloyd
7
8.7k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
498
130k
Facilitating Awesome Meetings
lara
29
4k
The MySQL Ecosystem @ GitHub 2015
samlambert
238
11k
Fantastic passwords and where to find them - at NoRuKo
philnash
27
1.5k
How to train your dragon (web standard)
notwaldorf
58
3.9k
The Power of CSS Pseudo Elements
geoffreycrofte
47
3.9k
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 の作成を始めやすいか。
ご清聴ありがとうございました!
質疑応答