API: 一般的な同期プロセス
教師と学生の同期、クラス、課題に推奨される呼び出し順序。
integrationapi
推奨順(名簿作成)
- 機関が開通済みで、商業状態が書き込みを許可していることを確認。
- クラス を同期または作成。
- 教師/学生 アカウントを同期。
- クラスメンバー 関係を作る。
- (任意)タスクを作成、または練習結果を取得。
同期戦略
- 増分: 更新時刻または変更カーソルで取得。全量上書きを避ける。
- 冪等: 外部システムの主キーを DodoSpeak のユーザー/クラス ID にマップ。
- 失敗の隔離: 1 件の失敗でバッチ全体を落とさない。失敗キューを残し、手作業または自動リトライ。
開通前に ゴーライブチェックリスト を完了する。