現在GakuNin mAPで利用できるAPIは2種類あります。いずれもOpenSocialをベースとしたフォーマットでレスポンスはJSON形式です。
- #people #People API
グループを指定してそのメンバーに関する情報を取得するためのAPI - #groups #Groups API
SPコネクタに接続しているグループに関する情報を取得するためのAPI
いずれも、認証は学認におけるSPメタデータに記載されている証明書を用いたTLSクライアント証明書認証により行います。証明書の extended Key Usage (eKU) に clientAuth が記載されていなければなりません。
また、mAPが提示する証明書も学認におけるSPメタデータに記載されているものとなりますので、SP側で適切に検証してください。
...
People API
リクエストURL
Wiki マークアップ メンバーのみを取得 <span class="nolink">https://map.gakunin.nii.ac.jp/api/people/@me/</span>{*}{+}グループURLorID{+}*\[?lang=*{+}言語{+}*\]
Wiki マークアップ 管理者のみを取得 <span class="nolink">https://map.gakunin.nii.ac.jp/api/people/@me/</span>{*}{+}グループURLorID{+}*%2Fadmin\[?lang=*{+}言語{+}*\]
...
※ Required以外のフィールドは、利用者が同意したフィールドのみ送られます。また、全てのフィールドが存在しない(同意されていないもしくはSPが要求していない)場合はオブジェクトごと無くなります。
※ id には、mAPが発行する永続的な識別子のJavaScriptでの表現が入ります。SP毎に異なる値になりますが、同一SPに対しては同一ユーザについて常に同じ値を返します。
例: "https:\/\/map.gakunin.nii.ac.jp\/idp\/shibboleth!https:\/\/sp.example.ac.jp\/shibboleth-sp!S8Xi7R5Wf1pd8k8lq9eoiXyCtmw="
※ ここで送信される id と、ユーザ認証時にSimpleAggregationでmAPから送信されるeduPersonTargetedIDは一致します。
※ 特に、文字列中にUnicodeのコード表記(例:\u3042)の形式の文字を含む可能性があります。
※ 指定されたグループに下位グループが存在する場合、下位グループのメンバーも含まれます。
...
Groups API
リクエストURL
- SPコネクタに接続しているグループ情報の取得
言語]
...