現在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
メンバーのみを取得 <span class="nolink">httpsメンバーのみを取得Wiki マークアップ
https://map.gakunin.nii.ac.jp/api/people/@me/</span>{*}{+}グループentityIDorID{+}*\[?lang=*{+}言語{+}*\] 管理者のみを取得 <span class="nolink">httpsWiki マークアップ - 管理者のみを取得
https://map.gakunin.nii.ac.jp/api/people/@me/</span>{*}{+}グループentityIDorID{+}*%2Fadmin\[?lang=*{+}言語{+}*\]
グループentityIDorID には グループentityID もしくは グループID を指定します。
...
グループentityID/ID | %2Fadmin | 取得値 |
---|---|---|
グループを指定 | 無 | グループメンバー一覧 |
〃 | 有 | グループ管理者一覧 |
SPコネクタを指定 | 無 | 仕様外 |
〃 | 有 | 仕様外 |
※ グループentityID/IDとして指定できるのは、SPコネクタに直接接続しているグループのみです。
...