ActionNew - ぺったんR Wiki - ぺったんR

new @ AboutController

リクエスト

method	GET
urlパラメータ	なし
POSTデータ	json形式*
html	○
json	○

解説

アイテムを新規作成するための入力フォームを表示する。

通常のrailsクライアントはこのAPIを呼び出してデフォルト値を補充したアイテムを受け取って入力フォームを表示する。しかし、ぺったんRはデフォルト値の補充マニフェストから受け取ることができるので、このAPIに頼らずとも入力フォームを表示できる。よって、この機能はサーバ限定と考えてよい。一応json形式のAPIも用意してあるが、使わない方が良いかもしれない。

urlパラメータ

なし

POSTデータ

auth_token

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

戻り値

正常系

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

例外系

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