こんなに簡単! Swagger Codegenのカスタマイズ - Qiita
waculでフロントエンジニアをしている @Quramy です。 今日はswaggerの話をしようと思います。 はじめに waculでは、API定義にはJSON Hyper Schemaを用いており、swaggerは現在利用していません。しかし、先月のOpen API Initiative発足等、にわかに盛りあがり始めたのを見て「swaggerも触ってみようか」と思い始めている状況です。 現状のサービス開発フローにおいても prmdを使ってJSON Hyper SchemaでAPI仕様を作成 1.の出力からサーバ側(golang)とフロント(TypeSciprt)用のコードを作成 2.をプログラムから利用 という流れを踏んでおり, 特に2.の部分は自作のライブラリで実現しています（この辺りの事情や実装は僕よりも @tutuming や @ukyo 達が詳しいです)。 swaggerにはsw
HerokuのAPIデザイン
Herokuが自ら実践しているAPIデザインガイドをGithubに公開した． “HTTP API Design Guide” このガイドは些細なデザイン上の議論を避けて，ビジネスロジックに集中すること目的としている．Heroku特有なものではなく，一般にも十分適用できる知見となっている． 最近は，モバイル向けにAPIをつくることも多いため，勉強もかねて抄訳した．なお内容は，HTTP+JSONのAPIについて基本的な知識があることが前提となっている． 適切なステータスコードを返す それぞれのレスポンスは適切なHTTPステータスコード返すこと．例えば，“成功"を示すステータスコードは以下に従う． 200: GETやDELETE，PATCHリクエストが成功し，同時に処理が完了した場合 201: POSTリクエストが成功し，同時に処理が完了した場合 202: POSTやDELETE，PATCHリク
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
