ManageBac+公開API
ManageBac+公開APIの仕組み、APIトークンの作成と管理方法、サポートされているフィールド、関数、権限、注意事項、変更履歴情報の入手先について学びましょう。
ManageBac+公開APIを使用すると、学校はManageBac+アカウントを、 ManageBac+と直接統合されていない外部プラットフォームに接続できます。
これらの設定は、学校のアカウントの管理者のみが構成できます。このガイドでは、セットアップ、トークン管理、サポートされている機能、技術的な注意事項、権限、およびよくある質問について説明します。
概要
ManageBac+の公開APIは、サードパーティシステムとのカスタム接続を構築する必要がある学校向けに設計されています。APIへのアクセスは、管理者が作成および管理するトークンによって制御されます。
APIマネージャーからは、トークンの作成、権限の制御、トークンステータスの確認、リファレンスドキュメントへのアクセス、API変更履歴の表示が可能です。
主要概念/新機能
サポートされているフィールドと関数
左側のメニューから「リファレンスドキュメント」タブを開くと、API接続の設定に関する詳細な手順が表示されます。サンプルリクエストとレスポンスに関する注記も含まれています。このページの上部にはバージョン選択ドロップダウンがあり、さまざまなAPIバージョンに対応したリクエストを選択できます。
API権限
権限フィールドについては、 「なし」を選択するか、読み取り専用権限を持つフィールドのみを選択するか、 「すべて」を選択できます。また、チェックボックスをオンにして個々のフィールドを選択することもできます。
学生
- 索引
- 見せる
- 作成する
- アップデート
- アーカイブ
- アーカイブ解除
両親
- 索引
- 見せる
- 作成する
- アップデート
- アーカイブ
- アーカイブ解除
教師
- 索引
- 見せる
- 作成する
- アップデート
学年別
- 索引
- アドバイザー
- 学生
- 学生を追加する
- 学生を削除する
- 学期出席
- 日付出席
クラス
- 索引
- 見せる
- 学生
- 学生を追加する
- 学生を削除する
- 学期出席
- 日付出席
授業評価
- 成績・学期成績
会員制度
- 索引
学校
- 見せる
- 学年度
- 対象
- 成績
タスク
- インデックス表示学生
API関数
学年別
- 全学年を取得
- アドバイザーを探す
- 学年ごとに生徒を集める
- 生徒を学年グループに追加する
- 学年グループから生徒を削除する
- 学年別・学期別のホームルーム出席状況を取得する
- 指定した日付の学年グループのホームルーム出席状況を取得する
クラス
- すべてのクラスを取得する
- クラスを受講する
- 授業の生徒を集める
- クラスに生徒を追加する
- 生徒を授業から退出させる
- 授業の課題を取得する
- 授業の課題を受け取る
- 課題とクラスに関する学生評価結果を取得する
- 授業の学期末成績を取得する
- 学期中のクラスの全成績を取得する
- 学期中の授業の出席状況を取得する
- 特定の日付の授業出席状況を取得する
会員制度
- すべてのメンバーシップを取得する
学生
- すべての学生を取得する
- 学生をゲットしよう
- 新しい学生を作成する
- 学生の最新情報
- 学生のアーカイブ
- 学生のアーカイブを解除する
教師
- すべての教師を取得する
- 先生を雇おう
- 新しい教師を作成する
- 教師を更新する
両親
- すべての親を取得する
- 親を捕まえる
- 新しい親を作成する
- 保護者情報を更新する
- 親をアーカイブする
- 親フォルダのアーカイブを解除
学校
- 学校の詳細情報を取得する
- 学年度を取得する
- 学校の成績を取得する
- 学校の科目を取得する
公共事業
- ピング
- アバターを入手
API変更履歴
ManageBac+で API の変更履歴を確認するには、 [設定] > [開発] > [API マネージャー]に移動してください。このページの下部にある[変更履歴]セクションには、新しいフィールド、追加または変更されたエンドポイント、その他の関連する技術的な変更など、最近の API の更新が時系列順に一覧表示されます。
ステップバイステップナビゲーション
ManageBac+公開APIを有効にしてトークンを追加する
- 設定 > 開発 > API マネージャー > 新しいトークンの追加に移動します。
- 「新しいトークンを追加」をクリックしてください。
- トークンの用途が容易に識別できるよう、明確で分かりやすいトークン名を入力してください。
- 更新および取得したい項目を選択してください。対象となる項目には、生徒、保護者、教師のデータ、IBグループ、クラス、学校設定などが含まれます。
- トークンを生成するには、 「トークンを追加」をクリックしてください。
APIトークンの編集または管理
- 設定 > 開発 > API マネージャーを開きます。
- クリップボードアイコンを使用してトークンをコピーし、別の信頼できるシステムで使用してください。
- トークンの権限を表示するには、 iアイコンにカーソルを合わせてください。
- トークンの状態を確認し、有効になっているか無効になっているかを確認してください。
- 権限を調整したり、トークンを無効または有効にするには、 「編集」をクリックしてください。
- 連携が不要になった場合は、ゴミ箱アイコンを使用してトークンを削除してください。
警告および重要な注意事項
セキュリティ警告
APIトークンは信頼できる相手とのみ共有してください。APIトークンをメールで送信したり、SSL暗号化されていないフォームに保存したりすることは絶対に避けてください。連携機能が不要になった場合は、削除アイコンをクリックしてAPIトークンを無効にすることをお勧めします。
APIノート
- null値は決してレンダリングされません。
- POSTリクエストでは、null値は無視されます。
- 空の文字列値は無視されず、既存の値を上書きします。
- 一括割り当てのユーザー(例: parent_idsまたはchild_ids)が見つからない場合、呼び出しはエラーを返します。
- インデックス操作で使用できるパラメータは、 AND論理を使用してスタックされます。削除によってレコードの変更タイムスタンプが変更されないため、 modified_sinceとdeleted_sinceを同時に使用すると、期待どおりの結果が得られない場合があります。
- セキュリティ上の理由から、管理者権限を持つユーザーはAPIを通じて読み取り専用となります。
- すべてのタイムスタンプフィールドは、ISO8601形式です。たとえば、yyyy-mm-ddThh:mm:ss.sssTZの形式で、 2017-11-06T04:35:00.000GST のようになります。
- APIに関するご質問やご不明な点がございましたら、 api@managebac.comまでお問い合わせください。
レート制限
APIリクエストの上限は、同一IPアドレスからのリクエストが1分あたり200件です。
よくある質問
ManageBac+は他のプラットフォームと連携できますか?
製品が「設定」>「連携」>「パートナー」に表示されていない場合、正式な連携関係は存在しません。このような場合でも、学校は公開APIを使用して独自の連携を確立できる可能性があります。
ManageBac+サポート担当者は、私たちの学校向けにシステム連携を構築できますか?
ManageBac+と連携させたいシステムをお知らせください。弊社としては、そのツールやサービスと直接提携することが、企業として、また製品として適切かどうかを検討いたします。
ManageBac+サポート担当者にAPIリクエストの作成を依頼することは可能でしょうか?
ManageBac+サポートチームはAPIに関する質問や問題についてガイダンスを提供できますが、すべてのAPIリクエストは学校側で直接行う必要があります。カスタム接続を確立する場合は、IT部門にご相談ください。
ManageBac+ APIのレート制限は何ですか?
APIリクエストの上限は、同一IPアドレスからのリクエストが1分あたり200件です。
ManageBac+公開APIの使い方に関するガイダンスはどこで入手できますか?
各フィールドの詳細および最新の変更履歴については、 「設定」>「開発」>「参考資料」を参照してください。
APIリクエストに問題が発生しました。誰に連絡すればよいでしょうか?
リクエストの詳細と発生しているエラーを明記の上、 api@managebac.comまでメールでご連絡ください。
要約すれば
- ManageBac+公開APIを使用すると、学校は管理者が管理するトークンを介してManageBac+外部システムに接続できます。
- 設定 > 開発 > API マネージャーからトークンの作成、確認、編集、無効化、削除を行うことができます。
- リファレンスドキュメント、権限、APIに関する注意事項、変更履歴の詳細、および一般的なサポートガイダンスはすべて、APIマネージャーのワークフロー内で利用できます。
ManageBac+学校がAPIアクセスを安全かつ権限ベースで維持しながら、カスタム統合を構築するための管理された方法を提供します。