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
350
swagger editor を趣味で活かす
kanayannet
February 02, 2019
Tweet
Share
More Decks by kanayannet
See All by kanayannet
FW と ライブラリ の考え方
kanayannet
0
86
TDDと今まで
kanayannet
0
270
個人開発 稼げなくてもいいアプリ
kanayannet
0
390
システムの堅牢性
kanayannet
0
190
Agile的学習方法
kanayannet
0
200
GUIをエンジニアが考える
kanayannet
0
170
http2http3
kanayannet
0
130
old typeからのクラウドインフラ
kanayannet
0
300
疎結合と認知
kanayannet
0
330
Other Decks in Programming
See All in Programming
Prompt FlowによるLLMアプリケーション開発
yuto2000
1
1k
Namespace on read
tagomoris
2
370
CSC307 Lecture 11
javiergs
PRO
0
240
社内 LT 会を発足し、アウトプット文化を醸成させるために考えたこと・やったこと / Starting internal LT meetings and fostering an output culture
mackey0225
3
120
ぼっちを避けて楽しむためのアノテコノテ / Various Tips and Tricks to Avoid Loneliness and Have Fun
nrslib
3
1.7k
Polarsの成長: v0.14からv1.0までの変遷と今後の展望
zerebom
1
350
DDDを志して3年経ったら「DDDの皮を被ったクリーンアーキテクチャ」になった話【デブサミ2024夏】
texmeijin
1
620
最近追加した型の紹介とその振り返り
aki19035vc
0
180
CSC307 Lecture 13
javiergs
PRO
0
150
I/O Extended Android in Korea 2024 ~ Whats new in Android development tools
pluu
0
250
リハビリmruby
kishima
1
160
英語
s_shimotori
1
220
Featured
See All Featured
Designing Dashboards & Data Visualisations in Web Apps
destraynor
226
52k
Scaling GitHub
holman
458
140k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
228
16k
In The Pink: A Labor of Love
frogandcode
139
22k
The Straight Up "How To Draw Better" Workshop
denniskardys
229
130k
How to train your dragon (web standard)
notwaldorf
79
5.5k
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
353
29k
Building Applications with DynamoDB
mza
89
5.8k
Why Our Code Smells
bkeepers
PRO
332
56k
ReactJS: Keep Simple. Everything can be a component!
pedronauck
662
120k
Making Projects Easy
brettharned
111
5.7k
A designer walks into a library…
pauljervisheath
201
24k
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 の作成を始めやすいか。
ご清聴ありがとうございました!
質疑応答