show @ StoriesController

ストーリー単体閲覧。

url

リクエスト

認証読者*
権限
methodget
urlパラメータid
POSTデータjson形式*
html
json
jsonp×

*オープンモードのとき、誰でも可 →RunMode

解説

ストーリーの情報を得るための機能。

  • セッションまたは認証トークンからユーザアカウントを特定する。
  • ストーリーモデルに単体取得を問い合わせ、その結果を対象ストーリーとして取得する。
    • 要求されたidとロールリスト(ユーザアカウントと管理者アカウント)を渡す。
  • 取得したデータを返す。

urlパラメータ

id

  • ストーリーid

POSTデータ

戻り値

正常系

  • htmlのとき、ステータスコード200 OKとともに、テンプレートから起こしたページを返す。
  • jsonのとき、ステータスコード200 OKとともに、json構造のデータを返す。
    • 出力はストーリーモデルのjson単体出力オプションに従う

参考:StoriesShowView

例外系

  • ユーザまたは管理者アカウントでサインインしてなかった。(Devise)
    • htmlなら、ステータスコード302 Foundを返すとともに、サインインを促すページ(/users/sign_in)へ遷移する。
    • jsonなら、ステータスコード401 Unauthorizedを返すとともに、応答メッセージにUnauthorizedを返す。
    • ただし、オープンモードで起動しているなら、サインインの必要はないので例外とはならない。
  • 対象ストーリーがなかった。(StoryModel)
    • htmlなら、例外404 not_foundを返す
    • jsonなら、例外404 not_foundを返す
  • 対象ストーリーに対する閲覧権限がなかった。(StoryModel)
    • 例外403 forbiddenを返す
    • 例外403 forbiddenを返す