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
360
swagger editor を趣味で活かす
kanayannet
February 02, 2019
Tweet
Share
More Decks by kanayannet
See All by kanayannet
github copilot と 心理的安全性
kanayannet
0
130
FW と ライブラリ の考え方
kanayannet
0
180
TDDと今まで
kanayannet
0
510
個人開発 稼げなくてもいいアプリ
kanayannet
0
490
システムの堅牢性
kanayannet
0
260
Agile的学習方法
kanayannet
0
250
GUIをエンジニアが考える
kanayannet
0
220
http2http3
kanayannet
0
170
old typeからのクラウドインフラ
kanayannet
0
360
Other Decks in Programming
See All in Programming
Jasprが凄い話
hyshu
0
180
複数のAWSアカウントから横断で 利用する Lambda Authorizer の作り方
tc3jp
0
120
Datadog DBMでなにができる? JDDUG Meetup#7
nealle
0
160
⚪⚪の⚪⚪をSwiftUIで再現す る
u503
0
100
color-scheme: light dark; を完全に理解する
uhyo
7
500
AIプログラミング雑キャッチアップ
yuheinakasaka
19
5k
未経験でSRE、はじめました! 組織を支える役割と軌跡
curekoshimizu
1
200
Boos Performance and Developer Productivity with Jakarta EE 11
ivargrimstad
0
580
Expoによるアプリ開発の現在地とReact Server Componentsが切り開く未来
yukukotani
1
200
Serverless Rust: Your Low-Risk Entry Point to Rust in Production (and the benefits are huge)
lmammino
1
160
The Clean ArchitectureがWebフロントエンドでしっくりこないのは何故か / Why The Clean Architecture does not fit with Web Frontend
twada
PRO
48
15k
Visual StudioのGitHub Copilotでいろいろやってみる
tomokusaba
1
210
Featured
See All Featured
Why Our Code Smells
bkeepers
PRO
336
57k
Learning to Love Humans: Emotional Interface Design
aarron
273
40k
Being A Developer After 40
akosma
89
590k
Fireside Chat
paigeccino
35
3.2k
How to Ace a Technical Interview
jacobian
276
23k
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
13
1k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
44
7.1k
How STYLIGHT went responsive
nonsquared
99
5.4k
How to Think Like a Performance Engineer
csswizardry
22
1.4k
Keith and Marios Guide to Fast Websites
keithpitt
411
22k
Building Your Own Lightsaber
phodgson
104
6.2k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
32
2.2k
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 の作成を始めやすいか。
ご清聴ありがとうございました!
質疑応答