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
370
swagger editor を趣味で活かす
kanayannet
February 02, 2019
Tweet
Share
More Decks by kanayannet
See All by kanayannet
無関心の谷
kanayannet
0
200
生成AIの使いどころ
kanayannet
0
150
github copilot と 心理的安全性
kanayannet
0
190
FW と ライブラリ の考え方
kanayannet
0
220
TDDと今まで
kanayannet
0
540
個人開発 稼げなくてもいいアプリ
kanayannet
0
520
システムの堅牢性
kanayannet
0
290
Agile的学習方法
kanayannet
0
280
GUIをエンジニアが考える
kanayannet
0
250
Other Decks in Programming
See All in Programming
アンドパッドの Go 勉強会「 gopher 会」とその内容の紹介
andpad
0
280
C++20 射影変換
faithandbrave
0
550
LINEヤフー データグループ紹介
lycorp_recruit_jp
0
1.6k
コードの90%をAIが書く世界で何が待っているのか / What awaits us in a world where 90% of the code is written by AI
rkaga
49
32k
生成AIコーディングとの向き合い方、AIと共創するという考え方 / How to deal with generative AI coding and the concept of co-creating with AI
seike460
PRO
1
340
XP, Testing and ninja testing
m_seki
3
220
プロダクト志向なエンジニアがもう一歩先の価値を目指すために意識したこと
nealle
0
120
今ならAmazon ECSのサービス間通信をどう選ぶか / Selection of ECS Interservice Communication 2025
tkikuc
20
3.8k
ReadMoreTextView
fornewid
1
490
エンジニア向け採用ピッチ資料
inusan
0
180
Create a website using Spatial Web
akkeylab
0
310
PHPで始める振る舞い駆動開発(Behaviour-Driven Development)
ohmori_yusuke
2
240
Featured
See All Featured
Producing Creativity
orderedlist
PRO
346
40k
Side Projects
sachag
455
42k
Rails Girls Zürich Keynote
gr2m
94
14k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
29
1.8k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
252
21k
Intergalactic Javascript Robots from Outer Space
tanoku
271
27k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
233
17k
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
panda_program
107
19k
XXLCSS - How to scale CSS and keep your sanity
sugarenia
248
1.3M
Agile that works and the tools we love
rasmusluckow
329
21k
Building a Scalable Design System with Sketch
lauravandoore
462
33k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
46
9.6k
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 の作成を始めやすいか。
ご清聴ありがとうございました!
質疑応答