割り当て一覧

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

割り当ての一覧情報を取得します。

パスパラメータ

site_idstringrequired

サイトID

リクエストボディ

get_countbooleanrequired

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

orderenum

昇順/降順。["asc", "desc"]から選択。デフォルト："asc"

sortenum

一覧情報をソートする項目。["id", "name", "allocation_start_date", "allocation_end_date"]から選択。デフォルト："id"

perinteger

一覧情報の取得単位。デフォルト及び上限値：1,000

pageinteger

perで区切られた一覧情報のインデックス。デフォルト：1

keyword[string]

フリーワード検索による絞り込み。複数値でAND検索が可能。検索項目：割り当て条件名

course_idinteger

科目IDによる絞り込み。

レスポンスボディ

countinteger

取得割り当て数。get_count: true 時に返却。

page{current: integer, max: integer}

一覧のインデックス情報。current: 現在値, max: 上限値

perinteger

リストの取得単位

lecture_settings[{ id: integer, subject: { id: integer, name: { ja: string, en: string, zh_CN: string, zh_TW: string } }, course: { id: integer, name: { ja: string, en: string, zh_CN: string, zh_TW: string } }, name: string, allocation_start_date: string, allocation_end_date: string }]

割り当て情報。割り当てID, 教科情報(教科ID, 教科名), 科目情報(科目ID, 科目名), 割り当て条件名, 割り当て開始日, 割り当て終了日を取得。

allocation_start_datestring

割り当て開始日。

allocation_end_datestring

割り当て終了日。

エラーレスポンス

400URLに誤りがあります。

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

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

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

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

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

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

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

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

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

403認証に失敗しました。

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

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

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

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

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

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

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

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

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

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

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

リクエストボディ例

{
  "get_count": false,
  "sort": "allocation_end_date",
  "order": "desc",
  "keyword": [
    "全受講者"
  ],
  "course_id": 999999
}