回答レポート

PATCHhttps://manabeat.com/{site_id}/mana_apis/answer_report

ユーザー別に問題・アンケートごとの回答履歴を取得します。

next_page_tokenの仕様

per（デフォルト：1000）行より取得可能なデータ数が多い場合、レスポンスとしてnext_page_tokenが発行されます。
2ページ目以降のデータ取得はnext_page_tokenをパラメータにセットしてください。
全データの取得が完了した時点でnullが返却されます。

初回リクエストの絞り込み要素を引き継ぐため、next_page_tokenをセットしたリクエストではその他全てのパラメータが排除されます。

トークンの有効期限は30分です。一度使用したトークンの再使用は出来ません。

パスパラメータ

site_idstringrequired

サイトID

リクエストボディ

*userstringrequired

ログインID

get_countboolean

true: 割り当て数のみ取得。false: 一覧情報を取得。

*next_page_tokenstringrequired

2ページ目以降のデータ取得用に発行されたトークン。

perinteger

データの取得単位。デフォルト及び上限値：1,000

subject_ids[integer]

教科IDによる絞り込み。複数指定可能。

course_ids[integer]

科目IDによる絞り込み。複数指定可能。

course_typeenum

科目種別による絞り込み。["normal", "adaptive"]から選択。

material_ids[integer]

教材IDによる絞り込み。複数指定可能。

optionalboolean

教材が属する科目が任意で割り当てられているかの可否。true: 任意割り当て, false: 必須割り当て

* user, next_page_tokenのいずれか一つ必須。

レスポンスボディ

countinteger

取得データ数。get_count: true時に返却。

perinteger

リストの取得単位

next_page_tokenstring

次ページが存在する場合に発行されるトークン。

answer_reportarray

以降の各パラメータを持つデータをリスト形式で返却する。

user_idinteger

ユーザーID

loginstring

ログインID

user_namestring

ユーザー名

subject_idinteger

教科ID

subject_name{ja: string, en: string, zh_CN: string, zh_TW: string}

教科名

course_idinteger

科目ID

course_name{ja: string, en: string, zh_CN: string, zh_TW: string}

科目名

material_idinteger

教材ID

material_name{ja: string, en: string, zh_CN: string, zh_TW: string}

教材名

question_idstring

問題ID

question_typestring

問題形式

correct_answer[string]/[{ja: string, en: string, zh_CN: string, zh_TW: string }]

正答値。オリジナル教材の場合に各言語で出力。

selected_answer[string]/[{ja: string, en: string, zh_CN: string, zh_TW: string }]

ユーザー回答値。オリジナル教材の場合に各言語で出力。

judgementstring

判定結果

answer_timestring

回答時間(HH:MM:SS)

answered_atstring

回答日時(yyyy/mm/dd HH:MM:SS)

エラーレスポンス

400URLに誤りがあります。

リクエストURL、パスパラメータを確認してください。

400Content-Type情報が不正な値です。

リクエストヘッダー情報を確認してください。

400リクエスト内容を認識できません。

リクエストボディの読み込みに失敗しました。送信データを確認してください。

400使用出来ないパラメータが含まれています。parameter1…

メッセージに記載された項目のパラメータが使用できません。データ型等確認してください。

400必須パラメータが不足しています。parameter1…

一覧情報取得に必須のパラメータが不足しています。

400このトークンは無効です。next_page_token

セットされたトークンは期限切れ、または存在しません。

403認証に失敗しました。

APIの認証に失敗しました。サイトID、APIキー、APIキー保有ユーザーの状況を確認してください。

403許可されていないIPからのリクエストです。

IPアドレス制限によってリクエストが制限されています。

413リクエストボディサイズが上限に達しています。

送信できるリクエストボディのサイズは100KBです。

429リクエスト制限中です。

1時間あたりのリクエストが5000回を超えています。時間を空けてからお試しください。

500予期せぬエラーが発生しました。

システム内部でエラーが発生しました。時間をおいて再度お試しください。

503システムメンテナンス中です。

現在システム全体のメンテナンス中です。終了までお待ちください。

503現在別のレポートAPIを処理中のため、APIを実行できません。

サイト内で実行可能なレポートAPIは同時に一つのみです。時間を空けてからお試しください。

503サイト内でレポートCSVエクスポートを処理中のため、APIを実行できません。

サイト内でレポートCSVエクスポート中はレポートAPIを実行できません。時間を空けてからお試しください。

リクエストボディ例（初回）

{
  "user": "user9999",
  "subject_ids": [
    1234,
    5678
  ],
  "course_type": "normal",
  "material_ids": [
    1234
  ],
  "optional": false
}

リクエストボディ例（2ページ目以降）

{
  "next_page_token": "abcdefghi123456789"
}