search @ PicturesController

md5検索の一覧

url

リクエスト

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

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

解説

実素材をmd5から検索して、一覧形式で表示する。新着順に表示される。自分が投稿しようとしている画像が既に誰かの手によって共有されていないか確認するために使う。

  • セッションまたは認証トークンからユーザアカウントを特定する。
  • ユーザアカウントから作家を取得する。
  • 実素材モデルにmd5検索を問い合わせ、その結果を実素材リストとして取得する。
    • md5を渡す。
  • 取得したデータを返す。

urlパラメータ

md5

  • 検索したい画像のmd5値。

POSTデータ

auth_token

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

戻り値

正常系

  • htmlのとき、ステータスコード200 OKとともに、テンプレートから起こしたページを返す。
  • jsonのとき、ステータスコード200 OKとともに、json構造のデータを返す。

参考:PicturesSearchView

例外系

  • ユーザまたは管理者または借手アカウントでサインインしてなかった。(Devise)
    • htmlなら、ステータスコード302 Foundを返すとともに、サインインを促すページ(/users/sign_in)へ遷移する。
    • jsonなら、ステータスコード401 Unauthorizedを返すとともに、応答メッセージにUnauthorizedを返す。