第2章2回の修正

[nokhnaton]

実演中に見つけた問題点

[Takeno-hito]

追加で、このあたりを直してほしいです。

• proxy のところ：プロキシじゃなくてCORSの設定をしたくないですか？わざわざプロキシを使う理由はないと思います
• whoami エンドポイントじゃなくて me の方が一般的では？
• プロキシする　という言い回しはあんまり正式な用法じゃないと思います、少しひっかかります
• 「CORS を回避する」という言い方はあんまり好きではないです。CORS を正しく設定する、とかにするべきでは？

[hijiki51]

今回のような手元で立てる場合はProxyのほうが一般的なのでproxyでいいと思います（CORSになるのは手元環境による副作用であって本質ではないため）

[hijiki51]

プロキシする => プロキシを挟む とかかな？

[nokhnaton]

/whoamiは別に/meに書き換えなくてもいいかなって思ったので直してないです

[Takeno-hito]

申し訳ないですがはっきり言って /whoami はナシだと思います。URI はリソースを表現することが望ましいと言われています。
たとえ /whoami にしたままにするとしても「traQ やその他 traP のアプリケーションでの書き方に習って」ないのでこの文面の修正は必要です。

API 設計に関してはこのあたりの記事が参考になると思います。
https://note.com/yamarkz/n/n41e9ac83c896

[nokhnaton]

URI はリソースを表現することが望ましいと言われています。

参考として挙げられたURLに具体的に書かれてなかったので、私の解釈も含みますが、whoamiでも十分シンプルで直感的だと思います。
meに変えるでも別に良いとは思いますが、第一章も書き換えなければいけないので、このプルリクではやりたくないです。また、変えるならその告知はしたいです。

「traQ やその他 traP のアプリケーションでの書き方に習って」ない

「traQ やその他 traP のアプリケーションでの書き方に習って」いるのは、エンドポイントを叩いてログインしているか確認するところで、実際「traQ でも一番始めに whoami と同じ働きをするエンドポイントを叩き自分の情報を取得しています。」とあります

Dismiss the review