ページ ツリー

比較バージョン

キー

  • この行は追加されました。
  • この行は削除されました。
  • 書式設定が変更されました。

現在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コネクタに接続しているグループ情報の取得
    言語]

...