public-api

Public Deepen Activity

為一個已確認的 blueprint 裡的某個活動補 7 個教學深度欄位。

硬性前置條件：blueprint 必須透過 /course-blueprint/confirm 確認過（status=confirmed）。 未確認會直接 409。

context（course_title / audience / objectives）自動從 blueprint 取。

同步呼叫，3-6 秒回傳。

post/api/v1/public/activity/deepen

Request

  • Base URL: https://api.slidemaster.tw (the document declares no server; this is the origin it was published from)
  • URL: https://api.slidemaster.tw/api/v1/public/activity/deepen
  • Auth: none declared

Headers

Authorizationstring nullable
X-API-Keystring nullable

Request body

blueprint_idstring required

已確認的 blueprint_id（由 /course-experience/generate + /course-blueprint/confirm 產生）

activity_indexinteger required

blueprint.activities 陣列中要深化的活動索引（0-based）

language'zh-TW' | 'zh-CN' | 'en' | 'ja'

Response

Successful Response

prerequisitestring required

學員參與此活動前需具備的前置狀態

transition_triggerstring required

觸發進入下一個活動的信號

failure_signalsstring[] required

活動失敗的具體可觀察徵兆（3-5 條）

design_rationalestring required

為何在此安排此活動的理由（引用 context）

bloom_level'remember' | 'understand' | 'apply' | 'analyze' | 'evaluate' | 'create' required
gagne_eventinteger required

Gagné 九大教學事件（1-9）

success_criteriastring required

活動達成教學目標的可驗證事實

summarystring required
next_suggestionstring required

Changes

No recorded changes to this operation across all 1 revision of this API.