APIドキュメントをRedocで一新しました | AQ Tech Blog
概要 AQに入社して2年目、デジタルエンジニアリング部デジタルエンジニアリング1課の松浦です。 本記事は、私が携わったとある案件で利用していたAPIドキュメントを整備した際の記録です。 APIドキュメントの管理に困っている方の参考になればと思います。 導入経緯 もともとスプレッドシートで管理していたのですが、スプレッドシートの管理だと、差分を見るのが大変だったり、他社に利用してもらいにくいなど不便な点がありました。 またOpenAPIの仕様に合わせた記述をしたいという要望があったため、YAML + OpenAPIでの管理へ移行することとなりました。 導入ライブラリの選定基準 OpenAPIへの記述へ移行するに当たり、YAMLで書いた仕様書を何かしらの方法でレンダリングする必要がありました。候補としては、Redoc、Swagger UIが上がり、当初はSwagger UIを導入する予定だった
Twitterが無くなったらマジでどうすればいいのか分からない
Twitter古参勢なので、2009年くらいだっけ？台風が来てリアルタイムの情報が飛び交った時、2011年の地震、その後も電車運行情報からゲリラ豪雨、昨日の天体ショーまで大変お世話になっている。 リアルタイムの情報を時系列で（一時期迷走したが）表示できるSNSって他に無いんだよね。 この間どうしても欲しいものがあって、ある店に在庫情報を訪ねたところ「インスタで更新してます」とか言われたんだけど、インスタは時系列に並んでないからまあ見落としたよね。 Twitterオワコンとか無くなるとか平気で言うやつはどこから情報仕入れるつもりなの？ 実店舗ならまあなんとかなるけど、ニンダイや各種イベント情報や映画や本の発表とか 昔みたいに公式ホームページ巡回して「更新されてるか？」ってやるの？ 無理でしょ。もう無かった時代には戻れないでしょ。スマホだってそうでしょ。 リアルタイムのつぶやきデータを元にニュ
ラジオなにか聞きたいんだけど
なにかおすすめないかな リモワで9時18時ぐらい家にいるとラジオ聞けるよなって気付いた でも聞ける件数が多すぎてどれ聞いたら良いのか全然わからんし、ラジオってこういう時間帯のより夜中のもののほうが面白そうなイメージある 何でもいいから面白いと思ってるラジオあったら知りたい 今はラジオライフをキンドルアンリミテッドで借りてきて紹介されているもので東京のradikoで聞けるのを聞いている ところでラジオライフっててっきり名前からラジオ雑誌かと思ってたんだがラジオと怪しげなモノの紹介の雑誌なんだな どっちも普通の面して混ざってるので変な雑誌だ
（2週間で消える）タトゥーを入れてみた男たち | オモコロ
2週間で消えるオーガニックタトゥー「Inkbox」を使ってみて、タトゥーがある生活を疑似体験してみます。 突然ですが、今日はお2人にタトゥーを入れてもらいます。 ！！！？？？？？ この記事に登場する人： 原宿：オモコロ編集長。タトゥーを入れさせられることになった。 ダ・ヴィンチ・恐山：オモコロ編集部。タトゥーを入れさせられることになった。 加味條（かみじょう）：この記事を書いているライター。タトゥーを入れてみたい。 というわけで、今回はこの3人で体に墨を入れていきます。 といっても本物のタトゥーを入れるわけではありません。使うのはこちら。 Inkbox公式サイトより Inkbox（インクボックス）とは、2週間で消えるオーガニックタトゥー。 表皮に特殊なインクを浸透させることで、疑似タトゥーを楽しめるというものです。 いわゆるタトゥーシールよりも本物っぽく見えるのがポイント。表皮が代謝で入れ
【サクマ式ドロップス】と【サクマドロップス】の違いとは？ | 食・料理 | オリーブオイルをひとまわし
投稿者：オリーブオイルをひとまわし編集部 監修者：管理栄養士 渡邉里英（わたなべりえ） 2021年2月 5日 名作『火垂るの墓』で主人公である清太の妹、節子が肌身離さず持っていたドロップスの缶は多くの人が知るところであろう。ドロップスは現在でも販売されているが【サクマ式ドロップス】と【サクマドロップス】の2種類があることをご存知だろうか？今回はその違いと『火垂るの墓』に登場するのはどちらかを検証していこう。
ファイターズ新球場と公認野球規則の話
えっ！日本ハム新球場使えない！？ ファウルゾーンの広さ公認野球規則の規定に満たず https://www.daily.co.jp/baseball/2022/11/08/0015789449.shtml はてブでも盛り上がったこの話、補足が必要そうなので書きます。 「野球のルール」の話〜Offical Baseball Rules と 公認野球規則国際オリンピック委員会に加盟している、または加盟を目指すような多くのメジャースポーツには国際統括団体があって、競技規則を管理・維持・改定しています。 ちょっと特殊なのはゴルフで、セント・アンドリュースゴルフ場を保有するロイヤルアンドエンシェントゴルフクラブという組織が国際ゴルフ連盟に変わってゴルフのルールの管理をしていますが、世界中のゴルフ競技団体から人と意見を集めてルールの改定作業をしている、という点では他のスポーツと変わりません。 ところが野
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Sandy Bridge環境が力尽きた人へのメッセージ「10年ぶり自作PC復帰の古強者達へ」パソコン工房 秋葉原BUYMORE店で見かけたPOP