#129 エクセル仕様書からの脱却。中級エンジニアはOpenAPIを使い倒しなさい。

2023/3/26 ·

  • さて本日私が提供させていただくのはこちらのオープンAPIという仕様でございます仕様?何ですかそれは仕様ですかはいどういうことですかオープンなAPIなんですかこれはですねじゅんぺいくんに答えていただきましょうまずですねオープンAPIというのを聞いたことはございますかございませんございません



  • ございませんこれは有名なやつですかこれはですね今世の中にAPIと呼ばれているアプリケーションってすごくたくさんいっぱいあると思うんですがいっぱいありますねだいたいは呼ばれるやつは全部APIですね関数とか含めなめちゃいけんよなめちゃいけないいまだにモノリシックなアプリケーションはいっぱいございますモノリシックそうなのはいスクリプト



  • 一通りで書かれているスクリプトはいっぱいあるかで今回はですねその中でもAPIというものを非常に良い開発体験を通して作れるための日本語は大丈夫ですかね大丈夫ですかこれ今回はですね間違えたこのオープンAPIというのはですねそのAPIを作る上での開発体験を爆上げするための



  • ヤーツでございます 深井:開発体験、体験を爆上げ、はい 樋口:体験を爆上げします深井:簡単にできるとかってことですか?樋口:それは違う、なんかひょっとしてあれじゃないですか、やっぱ、ウェブAPIですね、まず深井:ウェブAPIですね樋口:ウェブAPIの開発が楽しくて楽しくて夜も眠れなくなる、そんなツールってことですか?深井:その通りです 樋口:すごい! 深井:はい 樋口:クリスマス前日の子供のようにワクワクして眠れなくなります 深井:やばい、すご!深井:朝5時に起きる次、次の日 樋口:すごい深井:そしてずっとね、ゲームして、で、あの



  • 学校行ってねどこまで進んだかっていうのを友達と話し合ってワクワクするっていう僕らの小学生時代ですねっていうのがずっとAPI触って学校行ったらどこまで実装したかっていう話をするってことになるんですか変態すぎるブラック企業すごい



  • 企業をオープンAPIを導入するだけで勤務時間外でどんどん開発が進むっていうそういうことですもしかしたら勤務時間なくしても進むかもしれない



  • 新しい働き方絶対入れた方がいい絶対入れた方がいい経営者目線だよねただ経営者目線で絶対入れた方がいいっす同じこと言いましょう同じこと言いましょう大事なんですねそういう冗談抜きにマジでやった方がいいっすっていうやつですねAPIを作ってるならだからバックエンドエンジニアは知らんやつはちょっとどうかしてるっていうやつですかそんなやつはねやっべまあまあまだまだまだチャンスあるからまだチャンスあるまだチャンスあるはい



  • ざっくりオープンAPIって言ったんですけどこれはですね仕様です取り決めはい取り決めはいなんか分かりづらいですね仕様って言われるとそうなんですよなのでざっくりじゃあどういう全体像なのっていうのをまずお話しますはいお願いしますはい商品説明はいまずAPIっていうのはだいたいエンドポイントと呼ばれるものがありますねはい何ですかそれは入り口出口ですか入り口出口はい



  • 田口?谷口?誰?谷口は誰?田口は誰だ?カトゥーンですねカトゥーンかカトゥーンあんま知らないからなエンドポイントっていうのはそのAPIにアクセスするための情報というか場所というか入り口か出口かですね入り口だねもっと具体的に言うとメソッドとパスの集合ですねURLというか



  • ゲットメソッドでこのユーザーっていうパスにアクセスしたらユーザーの情報を取れるしユーザーのパスでポストで送ったら新規作成できるしみたいなこれの一個一個の入り口のことをエンドポイントと言いますよとこれって簡単に見れた方がいいですよねリストとしてまとまってた方が使いやすいですよねAPI使うときにまあまあまあそんなのね別にテキストファイルでもできますよいやいやいやいや



  • 侮ってもらっちゃ困りますよ勘でないですこれはですねまずYAMLっていうYAMLかもしくはJSON形式でもいいんですけど特定の形式でこういうまず仕様を書けますよとでここは全然いいポイントじゃないですなんかね普通です普通どころか普段ならドキュメントで書けたところをYAMLとかJSONっていう新しい形式を学ばなきゃいけないんで



  • ややコストかかっちゃいますよねなんですけどそれだけじゃないんですこちらすごいポイントその1この仕様書をもとにMockサーバー立てれるどういうことですかつまり仕様書書くじゃないですかここのエンドポイントにアクセスしたらこういうの返ってきますよって仕様書きますよねするとそれ通りに動くサーバー立てれます伝わってますよ今でもそのそれでアプリケーションできちゃうじゃんなんてことを言っちゃったりするんですか



  • はいえ?モックサーバーっていうのがポイントですねまずモックっていうものはテストダブルまあいいやちょっと分かりづらい単語出すのでやめましょうモックっていうのは基本的に本物っぽい動きをするやつだけどあくまでぽいがポイントで基本的には動的なレスポンスは介しませんユーザーID15でユーザー作ってねって言っても



  • 絶対にIDさんのユーザーを作った結果が返ってくるみたいな決まった結果をそれっぽい結果を返すのをMockメソッドもしくはサーバーとかMockなんとかとかって言うんですけどそんなMockサーバーが立つっていうのをのりさんが言ってますそうですピンときてますか?ピンときてますあでも



  • 自販機のMockを考えると簡単ですねそれを何円入れてボタンを押したらジュースは出てくるんだけど何円入れたかは気にしないし何が出てくるかもそんな気にしない毎回同じものが出てくるちなみにそれを使わなかった時自分でMockサーバーを立てるってなった時がどれくらい大変なのかなっていうのがちょっとピンときてなかったんでどっちかというとピンときてなかったというか立てるかな僕はやったことありますあるんだはい



  • Mockのライブラリーがあるんですよねだからなんて伝えればいいか分かんないんですけどなんて伝えればいいか分かんないんですけどただ設計書と同じようなことを書きますよねこういうリクエストを受けたらこれを返すこのJSONを返すみたいなコードを一個一個書いていってそのファイル一個使ってMockサーバー立てるみたいな



  • あーちょっと大変なるほど今工数算出できたわどんぐらいですか?使用書を1としますはいおそらく1.5から2ぐらいかかるでしょうあーそんぐらいなんですか?つまり2.5から3ぐらいかかるでしょうあー



  • まあまあでもかかるかかるし設計書とそうすると設計書と同じ文句が立ち続ける保証はないですねそうですミスったら違うの返ってくるようになっちゃうんでそこでズレが発生したらトラブルますよねなんとそれが使用書と同じものがパッてできちゃうので



  • 1で済みますそれは簡単すごいそれはピンときました3倍3倍3分の13分の1はい3分の1ですそれは楽ですねはいなるほどしかもそのMock Serverができちゃえばフロントはもうバックの完成を待つ前にフロントのクライアントの開発始められるんでなるほどすごく開発が全体的にスムーズになりますなるほどはいピンときてますその2その2



  • 今のその2じゃないですねMockの延長線だから今すごいポイントだからそうだねその2ありますなんとこの仕様書をもとにクライアントライブラリが作れますどういうことでしょうかつまりAPIって基本的にそのサーバーになるじゃないですかAPIが情報を提供するサーバーになってますよねそれを使ってる側ってクライアントって言いますよねはい



  • なんとそのクライアントのコードを書いてくれますそれ使ったことない俺も使ったことないそうなの?けどできるっぽいそれってどういうことですかいろんな言語あると思うんですけどいろんな言語でクライアントライブラリってことはなんだ



  • クラスってこと?そうですクラス設計書に書いてあるパスとかをいろいろ叩いたりとかパラメーターの型チェックとかしてくれるのかな?どこまでやってくれるかやってくれます型チェックは別のエコシステム必要っぽいんですけど叩いてくれるところまでやってくれます



  • 叩いてくれるところにやってくれるんだなのでそのライブラリのクラスあるじゃないですかそれとインスタンス化して用意されたメソッド読んだらそれを取れるっぽいですそれはすごい



  • そうなんですすごい初めて知ったね俺も今知りました実は使ってないです実は最近かもしれないってこと?いやー多分最初からっすね僕が知らなかっただけですね僕も知らなかったなのでクライアントも結構楽に作れますね確かに確かにちゃんとその仕様書通りに取ってきてくれるしねなんならAPI作ってる側の人が自分のAPI試そうと思った時にその



  • ライブラリ使って叩けない時点で設計書を間違えてるかなみたいなねなんかそういうのもあるかもしれないですね設計書か実装どっちか間違えてるかなみたいなねそのクライアント側はそれも例えば自分でやるとしたらどんぐらいのボリュームになるんですかそっちはもう2じゃ済まないよ4そんな大変4そしたらそんな大変じゃないかそんな大変じゃないです多分



  • 取ってくる処理と例外処理必要だよね例外処理まで書いてくれるのか例外処理まで書いてくれない可能性ありますけどね例外処理いけるんじゃないかな多分エラーのレスポンスコードとか書けるからエラーアンドリブいけるんじゃないかなやってくれるのそこまでそこはちょっとね



  • 濁しておきましょうかねはいわかりましたとりあえずクライアントコードも作れますよとしかも仕様書作ってちょろっと生成するだけでできるとしかもこれいろんな言語で作れるっぽいですよほどマニアックな言語を使ってなければだいたいできますねJSのことが多いでしょうねそうだよね普通はそうなると思います



  • ただJSATフレームワークによりそうそんなことないのかな多分だけどフェッチするAPIは共通の使うんじゃないかなフェッチするAPIってなんですかフェッチはですねクライアントがAPIに対して問い合わせを行ってデータを取ってくるじゃないですかそういう別のアプリケーションからデータを持ってくることをフェッチって言ったりするんですねそうなんですかはい両方解説のコーナーです両方解説でしたはいえー



  • JavaScriptの場合はFetch APIみたいなのがあるんでそれを使うんじゃないかなって気がするんですけどそういうのが生成されますよっていうところで使用書書いてたけどこのMock Serverとクライアントライブラリー2つを生成してくれるっていうのが結構このねオープンAPIのすごいポイントですとすごいすごい



  • このオープンAPIを触っていると多分ですけどどっかしらで絶対スワッガーっていう単語に出会うんですよスワッガー急に流暢なRスワッガーに出会うんですよこのスワッガーっていうのが出てきたら何を思えばいいかっていう話を次しますねはい



  • まずですねこのオープンAPIっていう仕様にのっとったAPI設計をするためにそれらを助けてくれる神器があるんですよ神器?3種の神器が神の器ですねその3つっていうのにスワッガーの名前がついてるんですけどその1スワッガーエディターその2スワッガーUIその3スワッガーコードジェン



  • ちょっと質問していいですかスワがあって生きてるんですかまだ



  • これの解説をちょうどする予定でしたオープンAPIっていう仕様ができる前って実はもともとスワッガーっていう名前のオープンソースのプロジェクトだったんですねなんですけど買収されたりとか組織改変が起きたりしていろいろいろいろあって名前がオープンAPIに今は変わってます元スワッガーなんですね元スワッガー元スワッガー金鉄バッファローズみたいなもっとね



  • ギリ世代じゃないかな聞いたことあるぐらいですねそうか中村のりとかのりさんいましたね主砲ねゴルフやらせたらめちゃめちゃ飛ばす人ですねそこは知らないそっちの情報は知らないんですけど



  • それがスワッカーですと元々スワッカーという名前の時にツールが作られたので今もそのツール群にはスワッカーという名前がついているんですけど今も仕様の名前はオープンAPIという名前に変わっておりますなんですけどツールでスワッカーという名前がついたものを使うのでおそらく何かしら使うってなったらこの名前に出くわすとそういう時は過去の仕様の名前が残っているんだなと思っていただけたらわかりました



  • なんならじゃあそのスワガーをオープンAPIって言い換えていいってことですよねオープンAPIUIオープンAPIその名前にはなってないんだけどねツールたちはツールとしてその名前があるんですよ本当だスワガーエディターなんだてっきり全部オープンAPIっていう名前に変わったんだと思ってましたマジで?スワガーでしたスワガーの名前はちょっと残ってるんですよなので



  • でちょっとこれらのツール3つあるんで今回はですね全部紹介したいと思いますありがとうございます盛り盛りですねでちょっと順番前後しちゃうんですけどまずはちょっとスワッガーUIからいきますかねはいこれはですねユーザーインターフェースあそうユーザーインターフェースもうそのまんまなんですけどその仕様書を読み取って綺麗な見た目作ってくれますよっていうツールですねはいこれねいろんなので使えてあのウェブ上に



  • 公開することもできます公開APIの仕様としてだからそのスワッカUI組み込んだサーバーをデプロイしちゃって誰でもアクセスできるようにっていうこともできますしそれちょっとめんどくさいよってことであればVSコードとかの拡張機能があってそれ使えばとりあえずVSコード上で綺麗な見た目に整えたりっていうのができますねなるほど個人的になんですけど



  • VSコードちょっと重い個人的にでも全然快適に使えますこれがスワッカーUIでしたこれ本当見た目作るだけなんであっさりで終わりますよ綺麗な見た目してますよねデザイン素晴らしいなと思ってますすっごいシンプルだけど



  • 見やすいよね色ついててプルダウンとかも色々選べてそうねこのスワガUIなんですけどじゃあちょっとすいません何も見ずにさらっと言うので間違えてたら言ってください色々やってくれることがあって色々は言い過ぎかアクセスするためのコマンドとか作ってくれるんですよね確かに変わるコマンドみたいなAPI叩くときってポストマンとか使うじゃないですか



  • ポストマンのためのパラメータはなんかあるのかな普通にURLとあとヘッダーとかのサンプルとかそういうの出してくれたりとかあとコマンドラインで叩こうと思った時に必要なカールのサンプルのコマンドとかそういうの勝手に出してくれますこれはすごいっていうので便利以上スワガUIスワガUIとして使ったことは僕はほぼないですエディターについてるやつ



  • わかるっていうので次エディターですかそんぐらいの気持ちそうだねエディターと結構セットで使うね続いてエディタースワッグアエディター編集思想編集思想先ほどヤムルとかジェイソンとか言いましたけど実はあなたはヤムルを書く必要はございませんそうなんですかそうなんです



  • そうなんですかなんとこのスワックアイディターがあればボタンをポチポチして画面を作るだけで勝手にそのヤムルファイルが作られますそうなんですかあれもしかしてヤムル書いてた僕今までヤムル書いてましたマジで普通にスワックアイディターを使うとですねヤムル書かずにヤムル作れますなので実はヤムルを覚える必要もないです



  • ちなみにちょっと初歩的なあれだと思うんですけどYAMLとJSONはなぜ必要なんですかねそのファイルたちはあーえっとねもうあれだねそういうもんYAMLはなんかDockerみたいに要は立ち上げるために設定を書いたファイルみたいな感じでポートとかそういうのが書いてある設定ファイルでJSONは



  • その時のデータヤムルとジェイソンは同じものが入ってます内容としてはただ形式が違うだけヤムルもジェイソンもどっちみちキーバリュー型じゃないですか何かのキーがあってそれに対する値が入っているとか入れ子になるっていうものができれば何でもよくてそれの標準的な形式としてヤムルとジェイソンどっちも書けるようにしておいたよ用意しておいてくれてるんですねスワガーさんの親切さですねヤムルで書くことが多いかな



  • そうですね僕もYAMLで書くことが多いJSON多分ちょっとダブルコードめんどいダブルコードとかめんどいんでYAMLの方が楽に書けますねなんで必要なのかは僕思うところがあって



  • バージョン管理できるのが一番いいところだと思いますなるほどテキストファイルじゃないですか言うてテキストだとGitHubでバージョン管理と変更管理ができるんですよねこのコミットでどこ出したとかねっていうのが多分プログラマー的思考ですよね達人プログラマーで言う何事もテキストで管理しろと全部Gitに載せろとっていう思想に乗っ取ってると僕は捉えておりますなるほど



  • なるほどそれで僕ももう一個ありますはいおそらくその2つが使われているのは構造化データだからと思いますというとどういうことですか構造化データ要はテキストで書いて文章で書いたらはい人によって書き方変わっちゃうじゃないですかうんなるほどでもYAMLみたいに仕様が決まっててこっちがキーでそれに値するバリューがこれっていう風な構造がちゃんと出来上がってるんでうんうん人によって差異がなくなるんですよなるほどうん



  • なのでそういう構造化されたデータじゃないとプログラムは読めないのでそういう背景もあると思いますなるほどありがとうございますなんならあれじゃねじゅんぺいが言ってたのってUIだけで良くねえかって話じゃないそんなことないワードとかそうじゃないですかパワフルとかそれもありますデプロイというかする時に必要なのかなっていう感じなんですけどやむるデプロイする時にはね



  • いるのかもねそうだと思うその通りありがとうございますわかりましたありがとうございますスワックエディターの有名なサービスだとストップライトスタジオとかがあるんですかねなんですかそれはさっき言ったポチポチでやむをかけるやつです触ったことない



  • ポチポチヤムルストップライトスタジオで検索検索検索触ってみようこれすいませんのりさん使ったことありますかあります作成されるヤムルとかって割と綺麗にできる感じですよねそうだねそのストップライトスタジオの形式にフォーマットされて生成されるんでなんかヤムルちょっとさブレるじゃん



  • シングルコートで囲うか囲わないかみたいなところとかそういうの全部統一されますねへーなるほどありがとうございます得るものはありました僕はこれやったあとはもうコードジェンこれはクライアントライブラリーを作るための生成器みたいな感じなのでモック作ってくれるのはこれとはまた別なんですかモックこれなきが違うなモックどれなんだろう



  • MockはオープンAPI仕様のYAMLから勝手にできる感じですかねMockサーバーおそらくスワッカーコードジェンから作られますやっぱそうですよね一回僕過去に作ったことがあるんですけどその時はDockerで作りましたねDockerでスワッカーコードジェンCLIっていうコンテナというかイメージがあって



  • 本当にそれをJavaで動かして動かすだけでしたへーえっとのりさんがそれやった時ってチュートリアルのコードまんまって感じですかそれとも仕事で作ったやつですかほぼチュートリアルのまんまのやつを仕事に転用した感じですあのオープンAPI仕様なのにMockにする上でよくわからんエラー出るみたいなことありましたか



  • なんかあったと思うやっぱあるっすよねちょっと覚えてないけどでも確かに動かすの一筋縄ではいかなかったような記憶がありますね僕もなんか



  • 数年前にやった時に一筋縄にはいかなかったですけどそれのメリット享受しないにでも設計書としても非常に見やすいですしそのメリットを最大に享受するならその辺のお作法を学んで使うと生産性爆上がりって感じですねそうです積極採用していってほしいけどこればっかりはチームでやるって決めないと勝手にやると怒られると思うんでそうだねこれしかもあれなんですよね



  • 僕このオープンAPI一番最初に知ったのその社内ツールの開発に後からジョインした時だったんですよほうその時も全く知らなくてこのコードオープンAPIというものをはいはいはいでなんかこのスワッカー書くんだよって言われてえなんでって思ってめちゃめちゃ嫌なまま終わったあそうなんですねそうなんですねそのなんだろうねもうヤムルもそんななんか詳しいわけじゃないしまあ最初はそうですよねうんうんえ?



  • なんでエクセルでえ?みたいな感じでちょっと苦労した記憶ありますねはいはいはいなんでちゃんと導入するときはこれ使うとこういいんだよみたいなところをちゃんと説明しないとただよく分かんないやつで終わっちゃうかもしれないじゃあその進める上でここでこう言ってるんでって言いやすそうなサイトを説明欄に載せましょうなるほどねこのラジオがおすすめかなマジか30分くらいかかるさ聞くのにうん



  • 意識高くないと聞いてくれないからなこのラジオ聞いてる人みんな意識高いからな一応今回これの情報を集めるにあたって結構な記事を漁りましたはいはいはいざっくりオープンAPIだけで調べるとさっきのコードジェンの部分あんまり深掘りしてない記事とかも多かったですね使用書として使ってMockが動くぜで終わってるのが結構多かったですねそれでも相当すごいですけどね



  • だいぶすごいそれでもコードジェンのところはGoogleの公式ドキュメント見てこれがすごいぜって言われてこれそういえばなんだろうと思って調べたらこんな感じになってたって感じでしたねなるほどというところでこのオープンAPIAPI作る際は絶対開発効率開発体験が非常に良くなると思うんでねちなみにじゅんぺいくんに質問です明日じゃないな来週からこの設計書を無理やり入れようと思った時に障壁になるのは何ですか



  • 無理やり入れるのが絶対正義だとは言わないけど絶対正義だとして障壁になるもの秘密に触れない程度に自分たちがやりたい実装と実装をうまくこっちに反映させて実装できるかっていう工程設計書の移し替えとかトランスポートがめんどくさいそれはその通りだね



  • 別の質問にします次自分が入るプロジェクトでこれを入れようと思ったら入れますか周りを説得しきれるかすごい自信だ聞いてくれ聞いてくれれば相手の人間性次第説得のりさんに害虫してるもんね実質使いましょうって言って使って



  • ってくれる人たちだなって感じですよなるほどねうーんなんかそうねどうやって説得するここがいいんすよじゃあちょっとやるわいやいやいや今知ったんだけどなそうだね確かに



  • 初めましてこのプロジェクトに参加させていただいたんですけど新規プロジェクトということでちょっと時間も短いと思うんで最近知ったんですけど僕もオープンAPIっていう技術があって技術はい使用みたいなのがあってなんか聞いたことあるね調べていったら結構時間とか短くいけそうな結構簡単に最初のベースを作れそうな感じのものがあったのでちょっと待ってくださいいいよ



  • 何なのかマジでわかんない めっちゃごめんなさい あの1回質問していいですか?はい あの本当にさっきからちょっと聞こうと思ってたんですけど あのこれを導入するタイミングって えっと結構最初の方っていう認識で最初の方でそのベースを作る本当にあのそれこそ木が立つから 木が立ったり えっと



  • データをやり取りできたりするからフロントの人たちも作業に取り掛かれるしバックエンドも簡単に実装を始められるっていうところがすごいところですよね最初の頃にまだ出来上がってない何も結構真っさらな状態の時にこれをバーンって適用してそれを言ったら回収するみたいな使い方がオーソドックス



  • 多分そう設計書だと思うんですよ基本的にこれって設計書の作り方決めるタイミングって基本的にはプロジェクトの最初確かに



  • だから一番メジャーなのはそのタイミングだと思いますプロジェクトが開発チームができたぐらいが多分一番最初で第2のポイントとしては長く開発プロジェクトが続いてて情報管理むずみたいな今のこのExcelの設計書だとマジで管理めんどくさいどうしようってなったタイミングで



  • これオープンAPIだったらGitで管理できるし見やすいしMockもついでに立つらしいですよっていうのが多分第2のタイミングちなみに調べた中で出てきた記事だと第2のパターンで書いてる記事が多かったですね途中で入れたパターンですかおそらく最初から入れてる人は途中で入れたわけじゃないんで感動の差分が少ないから記事にしてないだけだと思うんですけど



  • 多分途中で入れた人が次最初から入れてるわけですからねそうそうだからシャドウを最初から入れてるがいっぱいあると思うんですけど設計書もできる僕はメインは設計書だと思ってる



  • 通称これスキーマ駆動開発って言われててスキーマ駆動開発スキーマ要は構造ですねその仕様の構造みたいなのを構造をもとに仕様書も作ってるしモックも作れるしクライアントライブラリも作れるしみたいな



  • こういうデータでやり取りしますよっていう構造をまず最初に定義してあげてそれが仕様書になってるみたいなイメージですね一番多分どのフェーズでもめっちゃ役に立つでしょっていうのが仕様の部分そういうこと感じなのかなエンドポイントとか書いてあるAPIとかが書かれたファイルみたいなのがバーっと一気にできるから便利



  • と思ってたんですけどそっちより手前のその仕様書みたいなが作られるのが一番いい とこというか便利なとここは機能がそこでそのすっコア機能から派生したのがいっぱいある感じがな なるほどわかりましたこれはあのねいわゆるエクセル仕様書者できないものだと思うのでてかエクセルですよね多分これじゃなかったら他なんで セールだと思うですよねうん



  • エクセル仕様と比べてGitでバージョン管理できるしメンテナンスできるしデザインも表頑張って書いたりとかしないで勝手にいい感じにやってくれるしちなみにフリーなんですよ無料なんですよね無料でもないお高いんでしょお高いんですかなんとこちら無料でございます無料なんですね



  • これ無料なんすね?すごい!そんなやって無料なんですかこれ今ならってことですか?さらに今なら?はい



  • ちっちゃいエンターキー出た出た伝わったかなこれ持ちネタ伝わんない可能性あるなちゃんと最後まで聞いてる人じゃないと分かんないんですよ最後まで聞いていただきたいですね今回はエンターキーですねエンターキーエンターキー大きくあってほしいスペースキーもですよね枕になる方のエンターキーであってほしいですね爪のサイズぐらいの小指のちっちゃいねなかなかちっちゃいね



  • 絶対デリートしちゃいます無料なんですよこんなツール無料で出してるのって相当世界に貢献してますよねバグってるよマジでバグってるありがたい使った方がいいですねちなみに障壁となるのは聞きたかったのは聞いてる人がさこのオープンAPIっていう情報を得た時に自分に還元するのがちょっと難しいだろうなと思って難しいなと思いつつ



  • じゃあリアルな声で障壁になるのなんだろうなと思って順便に聞いてみた次第ですそういうことですねたどり着かなかったですすいませんまあだからしょうがない個人的にはでもやっぱそのタイミングで途中か途中でチームの課題になるパターンかプロジェクトの最初に入れるパターンで根拠を示しながらやりたいっすって言えるかであとなおかつその根拠を示すときにプロトタイプを作っておくうん



  • のが非常に重要ですねプロトタイプでいうとスワガーエディター調べると出るんですよ最初からデフォルトの設計書がひな形みたいなのが自分で手を動かさずともそれ見せるだけでもね使ったらこうなんだっていうのが見えると思うのでぜひ説明欄とかに載せておくんでスマホで開いて見えるかはよく知りませんが



  • 見てみてください見れそうじゃない?なんかシンプルだし簡単そうに見れるかなー見れたらすごい多分すごいから見れるんでしょうけどなんで見れるように作ったんだろうって思うまあ確かにそのユースケースないだろ多分画面をすっごいちっちゃくしながらやってる人いるかもしれないいないだろそいつ環境改めろはいすいません



  • オープンAPIですねこれはバックエンドエンジニア必須のスキルだと思いますこれはバックエンドエンジニアのさ例えばスキル成長していく上でロードマップスキルのロードマップあると思うんですけどオープンAPIはマジで真ん中のパスに入ってると思います中級エンジニアになるためにもやっぱり通るべきとこなんならプロジェクト開発する



  • そうだな一人称で働けるエンジニアになるためにはそうだ中期エンジニアになるためには絶対にやれと思ってるどんぐらい重要かで言うと第一言語の次ぐらいに大事だと思うんですよめちゃくちゃ大事どっかとかそんぐらいだと思ってる俺はどっかまでいかないかどっかの次くらいUMLのちょっと上くらいUMLより俺結構上だと思ってます



  • まじかUMLも大事ですけどねあくまで個人的な意見ですけどポストマンと同じくらいポストマンと同じくらい使いますねそれは使いますポストマンは個人ですけどオープンAPIはチームなんで確かにチームの生産性を下げることになりますオープンAPI使わないと結構やっぱ使ってるんですか僕は使ってない



  • プロジェクトに入ったことはないえーあそうけど使ってないとこあるでしょうねあると思う納品されたソフトウェアの設計書はエクセルだったことはいっぱいあるあーそこが一個判断できるところですねうんまあ使ってないとこの方がまだ多い説はあるけどそうなんだそうなんですちっちゃプロジェクトとかだったらあんまなかったりするかなそうなんですね何であれ作るスタブロックこれ



  • 多分今ここのひまプロでプロジェクトやろ土日でちまちまって言っても多分作るっすおーまあそうね人によるっす必須ですね使える人間になってほしいひまじんプログラマー聞いてるバックエンドエンジニアみんなこれを使ってほしい普及してほしいですもし会社でまだ使ってないよってところがあったら説得しに行くとそう



  • 説得の材料はこれですねこれ今のバックビューバック伸びするなきっとこれバック伸びだな本当に開発便利になりますよっていうところをねおそらくオープンAPIをなんとなくふわっと知ってるけど何が便利なのっていうぐらいの層の反対にあいやすいと思うんでその辺はどうやって説得するかですよね社内政治だねここはそうですね人間楽したいんで



  • めんどくさいとこやってあげると結構やってくれますよたたき台作ってここからここまで作っておいたんでこれに書き加えるだけなんで同じやつGitにもプルリク出しておいたんだよってそこまでやったらこの子そんな頑張ってくれたから乗ってやるかっていう気持ちになります書き方レクチャー勉強会するとかねそれも大事ですあとなんかイグザンプルの



  • ファイル書いておくといいですねAPIでexampleって書いてこの通り書いたらget request書けるよみたいなねなるほどちなみに僕はそうしました今のプロジェクトはサンプル書いてこの通りやってくださいって言って分かんなかったらスラックで聞いてください何とぞってパワープレイ結構パワープレイパワープレイ好きなんです素晴らしい



  • パワーが足りないパワープレイが全てを解決するからねありがとうございますぐらい重要なんですねじゃあ終わりますか終わりましょう時間もいい時間なんでじゃあエピソードはなしでいきますかエンディングはなしで大丈夫ですそれでは皆さんもこのスワッカーエディター間違えたオープンAPIを使って開発体験バカゲでオープンなAPI設計をしていきましょうということであげぽよ



  • さあ皆さん次の商品は目玉商品ですこちらめちゃくちゃでかいエンターキーわー大きいこれがあるとストレス発散生産性アップ快適な睡眠もえ枕にしちゃうんですかこちらの商品はお値段など1024円わー2の10乗



  • そして今番組終了1時間以内にGoogleフォームよりお便りを送った方はちっちゃいスペースキーも付いてきますポケットに入れて持ち運べますね番組の高評価フォローもすると会員割引なんと90%オフほぼただ今すぐご応募を

0:00 38:22

#129 エクセル仕様書からの脱却。中級エンジニアはOpenAPIを使い倒しなさい。