OriginalPicturesShow - ぺったんR Wiki - ぺったんR

show @ OriginalPicturesController

原画の単票形式表示。

url

• http://localhost:3000/original_pictures/1
• http://localhost:3000/original_pictures/1.json
• http://localhost:3000/original_pictures/1.png

リクエスト

認証	読者
権限	オーナーまたは管理者
method	get
urlパラメータ	id
POSTデータ	json形式*
html	○
json	○
jsonp	×
png	○
gif	○
jpeg	○

解説

原画の情報を得るために使う機能。拡張子が画像フォーマットであれば、画像を返す。それ以外なら行データを返す。

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

urlパラメータ

id

• 原画のid

POSTデータ

auth_token

• 外部からjsonで要求する場合、認証処置として認証トークンが必要。

戻り値

正常系

• htmlのとき、ステータスコード200 OKとともに、テンプレートから起こしたページを返す。
• 画像のとき、ステータスコード200 OKとともに、対象原画モデルに画像のバイナリデータをもらって、それを返す。
  • 原画モデルにMimeTypeを問い合わせ、inlineで送信する。
• jsonのとき、ステータスコード200 OKとともに、json構造のデータを返す。
  • 出力フォーマットは原画モデルのjson単体出力オプションに従う

参考:OriginalPicturesShowView

例外系

• ユーザまたは管理者アカウントでサインインしてなかった。(Devise)
  • htmlなら、ステータスコード302 Foundを返すとともに、サインインを促すページ(/users/sign_in)へ遷移する。
  • jsonなら、ステータスコード401 Unauthorizedを返すとともに、応答メッセージにUnauthorizedを返す。
• 絵師登録してなかった。
  • htmlなら、ステータスコード302 Foundを返すとともに、絵師登録を促すページ(/artists/new)へ遷移する。
  • jsonなら、ステータスコード401 Unauthorizedを返すとともに、応答メッセージにUnauthorizedを返す。
• 対象原画が存在しなかった。(OriginalPictureModel)
  • htmlなら、例外404 not_foundを返す
  • jsonなら、例外404 not_foundを返す
• 対象原画に対する閲覧権限がなかった。(OriginalPictureModel)
  • htmlなら、例外403 forbiddenを返す
  • jsonなら、例外403 forbiddenを返す