ページ ツリー

比較バージョン

キー

  • この行は追加されました。
  • この行は削除されました。
  • 書式設定が変更されました。
コメント: Migrated to Confluence 4.0

現在GakuNin mAPで利用できるAPIは2種類あります。いずれもOpenSocialをベースとしたフォーマットでレスポンスはJSON形式です。

  • #People API#People API
    グループを指定してそのメンバーに関する情報を取得するためのAPI
  • #Groups API#Groups API
    SPコネクタに接続しているグループに関する情報を取得するためのAPI

いずれも、認証は学認におけるSPメタデータに記載されている証明書を用いたTLSクライアント証明書認証により行います。証明書の extended Key Usage (eKU) に clientAuth が記載されていなければなりません。
また、mAPが提示する証明書も学認におけるSPメタデータに記載されているものとなりますので、SP側で適切に検証してください。

People API

リクエストURL

  • Wiki マークアップメンバーのみを取得 <span class="nolink">httpsメンバーのみを取得
    https://map.gakunin.nii.ac.jp/api/people/@me/</span>{*}{+}グループentityIDorID{+}*\[?lang=*{+}言語{+}*\] Wiki マークアップ管理者のみを取得 <span class="nolink">https
  • 管理者のみを取得
    https://map.gakunin.nii.ac.jp/api/people/@me/</span>{*}{+}グループentityIDorID{+}*%2Fadmin\[?lang=*{+}言語{+}*\]

グループentityIDorID には グループentityID もしくは グループID を指定します。

...

グループentityID/ID

%2Fadmin

取得値

グループを指定

グループメンバー一覧

 〃

グループ管理者一覧

SPコネクタを指定

仕様外

 〃

仕様外

※ グループentityID/IDとして指定できるのは、SPコネクタに直接接続しているグループのみです。

...