DemandersArtistsExport - ぺったんR Wiki - ぺったんR

artists_export @ DemandersController

絵師エクスポート

url

• http://localhost:3000/demanders/artists_export.json

リクエスト

認証	借手*
権限	借受
method	get
urlパラメータ	date
POSTデータ	json形式*
html	×
json	○
jsonp	×

解説

借受に必要な絵師環境をエクスポートするための機能。開発者が目視でテストするためにブラウザから操作できるようなHTML形式のページに対応させたいところだが、仮にダウンロードできたとしても、インポート側がそのデータを受け取るようなAPIになっていないので、無意味だと判明。よって、 json形式のみの対応となる。

• 借手アカウントから借手モデルを取得する。
• 日付文字列変換を依頼して、エクスポート日時を取得する。
  • 前回インポート日付を渡す。
• 借手モデルに絵師エクスポートを問い合わせ、その結果を対象絵師リストとして取得する。
  • エクスポート日時を渡す。
• 作業結果をクライアントに戻す。

urlパラメータ

date

• 前回インポート日付
• YYYYMMDDの文字列
• 省略時は全件エクスポート

POSTデータ

auth_token

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

戻り値

正常系

• jsonのとき、ステータスコード200 OKとともに、json構造のデータを返す。

例外系

• 借手アカウントでサインインしてなかった。(Devise)
  • htmlなら、ステータスコード302 Foundを返すとともに、サインインを促すページ(/demand_users/sign_in)へ遷移する。
  • jsonなら、ステータスコード401 Unauthorizedを返すとともに、応答メッセージにUnauthorizedを返す。
• 借受権限がなかった。(DemanderModel)
  • 例外403 forbiddenを返す
  • 例外403 forbiddenを返す