現状/users/self/jsonのようにしているのですが、これで問題ないでしょうか?
そのような設計のアプリケーション、と決めるなら、それで問題ないと思います。
が、REST が前提だと、パスはあくまでリソースを表すべきで、 json
のような種別は別の部分に入れる気がします。
- extension を利用する
/users/self
/ /users/self.html
/ /users/self.json
/ ...
- パラメーターを利用する
/users/self?ext=html
/ /users/self?ext=json
/ ...
- ヘッダを利用する
Accept: text/html
/ Accept: application/json
/ ...
個人的には 1のケースが多いような気はしますが、どれを利用するかは完全に自由だと思います。
追記
ここでのAPIは公開用ではなく、アプリケーション内部でリソースにアクセスするために設置するものです。
もしくは、根本から分けることもできました
- パス
http://example.com/users/self
/ http://example.com/api/users/self
- ドメイン
http://web.example.com/users/self
/ http://api.example.com/users/self
バッドをするには、ログインかつ
こちらの条件を満たす必要があります。
2020/09/12 17:05