HomeResourcePictures - ぺったんR Wiki - ぺったんR

resource_pictures @ HomeController

マイ素材の一覧形式

url

• http://localhost:3000/home/resource_pictures
• http://localhost:3000/home/resource_pictures.json

リクエスト

権限	絵師
method	get
urlパラメータ	{page,page_size}
POSTデータ	json形式
html	○
json	○
jsonp	×

解説

自分の新着素材を一覧形式で表示する。

• セッションまたは認証トークンから作家アカウントを特定する。
• 作家アカウントから絵師データを取得する。
• 作家モデルにページ位置補正を依頼して開始ページを取得する。
  • urlパラメータpageを渡す。
• 作家モデルに素材ページ数補正を依頼して1ページの件数を取得する。
  • urlパラメータpage_sizeを渡す。
• 素材モデルにマイリストを問い合わせ、その結果を素材リストとして取得する。
  • 絵師とページ位置と件数を渡す。
• 取得したデータを返す。

urlパラメータ

page

• 表示するデータが何ページ目からのものか。

page_size

• 1ページに収まる行の数。

POSTデータ

auth_token

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

戻り値

正常系

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

参考:HomeResourcePicturesView

例外系

• 作家アカウントでサインインしてなかった。(Devise)
  • htmlなら、ステータスコード302 Foundを返すとともに、サインインを促すページ(/users/sign_in)へ遷移する。
  • jsonなら、ステータスコード401 Unauthorizedを返すとともに、応答メッセージにUnauthorizedを返す。
• 絵師登録してなかった。
  • htmlなら、ステータスコード302 Foundを返すとともに、絵師登録を促すページ(/artists/new)へ遷移する。
  • jsonなら、ステータスコード401 Unauthorizedを返すとともに、応答メッセージにUnauthorizedを返す。