APIソーシャル化をする上で最も重要な情報、それはソーシャルグラフです。APIにより取得した友人一覧を元にして、ソーシャルアプリケーションを開発することができます。多くのサービスにおいて、このAPIの利用は必須となることでしょう。APIについて、その使用方法を説明します。APIでは、いくつかご利用にあたり知っておくべきポイントがあります。これらのポイントを把握し、ガイドラインに沿った効果的なアプリケーションの開発を行っていただければ幸いです。APIですが、取得可能な情報には、ユーザが設定しているプロフィール画像のURLが含まれます。具体的には、thumbnailUrlがそれに該当します。このプロフィール画像は、実は以下の2種類が存在します。APIにて取得可能なユーザは、認可ユーザ自身もしくは認可ユーザの友人です。APIにアクセスした結果は「友人向け画像のURL」が得られます。友人の場合は、必ず友人向け画像のURLが結果として得られることになります。mixi.jpサイト内では、友人向けプロフィール画像は第3者に見られることがない画像として機能設計がされています。APIを使ったアプリケーションにおいても適用していただくために、以下のガイドラインを設けさせていただいております。友人向けのプロフィール画像は本人の承諾があっても第三者への公開はできません。http://developer.mixi.co.jp/connect/term/guideline_of_mixi_connect一方、認可ユーザ自身のプロフィール画像については、thumbnailPrivacyパラメータにeveryone値を指定することで、全体公開向けプロフィール画像をthumbnailUrlにて取得できるようになっています。この全体公開向け画像の扱いについては、ガイドラインにて以下のように規定させていただいております。本人の承諾を得た上であれば、本人のニックネームとプロフィール画像を第三者が閲覧できるようにすることを認めます。APIをご利用ください。APIにて取得されるプロフィールページのURL(profileUrl)については、ログインユーザとそのURLのユーザが友人関係である場合にのみ閲覧可能となっていました。mixiのサービスを通じて同じ興味を持った方々と新しいつながりを持ってもらいたいという方針になりprofileUrlについても友人以外のユーザでも閲覧可能となるURLを取得できるよう変更されました。取得したデータについてはガイドラインにおいて、以下のような規定をさせていただいており、それに沿ったアプリケーションにおいてAPIで取得した第三者の情報を扱うことは、ユーザの同意なく行うことは禁止となっております。取得したデータの利用、取り扱いについての補足事項http://developer.mixi.co.jp/connect/term/guideline_of_mixi_connect/codicil_of_term_1また、取得されるURLはPC用のものとなります。モバイル用のプロフィールページについてはドメインを"http://m.mixi.jp/"に変更したURLにアクセスしてください。APIを利用するためには、以下の情報をすでに入手している必要があります。APIにアクセスすることはできません。アクセストークンの入手方法については、認証認可手順のページをご覧ください。友人一覧の取得ユーザが登録している友人の一覧を取得するために、クライアントプログラムは"https://api.mixi-platform.com/2/people"にアクセスします。このURIは、以下の仕様となります。取得したいグループのID、または"@self"、"@friends"友人一覧はユーザのプライベートな情報となるため、User-IDはアクセストークンを認可したユーザ本人のIDまたは"@me"のみ指定することができます。mixiアプリからは本人以外のユーザを指定することもできます。詳細は「mixiアプリで「友人・友人の友人」以外のユーザ情報を取得する際の注意点」をご参照ください。Group-IDは、取得したいユーザの集合を特定するためのIDを指定します。指定可能なIDは、以下となります。APIにて取得することができます。APIでは、以下のクエリパラメータをサポートしています。説明sortByパラメータ値として"displayName"を指定することで、取得結果をニックネームによる並び順とすることができます。パラメータ値として"lastLogin"を指定した場合は取得結果をログイン時間による並び順とすることができます。指定した場合と同様の結果が返却されます。このパラメータ値として"ascending"を指定した場合は昇順、"descending"を指定した場合は降順に取得結果が並び替えされます。このパラメータを省略した場合は、昇順となります。パラメータ値として"everyone"を指定した場合は、レスポンスに含まれるthumbnailUrlが全体向けに設定したイメージのURLとなり、"friends"を指定した場合は、友人向けに設定したイメージのURLとなります。このパラメータを省略した場合は、thumbnailUrlは友人向けに設定したイメージのURLとなります。このパラメータは、User-IDにアクセストークンを認可したユーザ本人のIDまたは"@me"を指定し、且つGroup-IDに@selfを指定した場合にのみ有効となります。レスポンスに含まれるthumbnailUrlのschemeをパラメータ値として指定します。