mixi Developer Center (ミクシィ デベロッパーセンター)

mixiアプリ

mixiアプリ » 技術仕様(Graph API方式) » モバイル » URLのルール

URLのルール

mixiアプリにて利用可能なAPIによって、開発者はいくつかのURLを取得することができます。APIにて得られるURLは代表的なものであり、下記に示すルールに基づいてURLの一部を変更することで、例えば異なる大きさの画像を得ることができたり、携帯端末に対応したページを表示したりすることができるようになります。

本ページでは、具体的なURLのルールを紹介いたします。

注意
URLの仕様は、事前の予告により変更されることがございます。ご了承ください。

プロフィール画面のURL

mixiのユーザ情報などを表示するプロフィール画面(show_friend.pl)は、PC向けおよび携帯端末向けの2つのURLが存在します。

  • PC向け:
    http://mixi.jp/redirect_friend_api.pl?puid=xxxxxxxx&client_id=xxxxxxxx
  • 携帯端末向け:
    http://m.mixi.jp/redirect_friend_api.pl?puid=xxxxxxxx&client_id=xxxxxxxx

People API(profileUrl)にて取得されるURLは、PC向けのものとなります。携帯端末向けのURLは、PC向けのURLのドメインに"m."を追加することで得ることが可能です。

プロフィール画像のURL

ユーザーのプロフィール画像は、People API(thumbnailUrl)を利用することで取得できます。
大きさは3種類あります。(180×180, 76×76, 40×40)

180×180:  http://profile.img.mixi.jp/photo/member/{id1}/{id2}/{id3}.jpg
76×76  :  http://profile.img.mixi.jp/photo/member/{id1}/{id2}/{id3}s.jpg
40×40  :  http://profile.img.mixi.jp/photo/member/{id1}/{id2}/{id3}m.jpg

People API(thumbnailUrl)にて取得されるURLは、76×76の大きさとなります。他の大きさの画像のURLは、{id3}の直後の"s"を削除する、または"m"を追加することで得ることが可能です。

各サイズの縦横比は、160×180といったように、異なる場合があります。「180, 76, 40」という数値は、縦横それぞれの最大幅という意味となりますので、ご注意ください。

また、ホスト名に関しては、変更が行われる可能性がありますのでご注意ください。

(2016/10/24 追加)
モバイル版の暗号化通信が2016年12月中にSHA-2に切り替えられるのに伴い、以下のモバイル版での置換作業は不要となります。

  • 従来はこの置換によってSHA-2非対応機種でも利用可能なURLを提供しておりましたが、以後は置換後のURLもSHA-2化されます。
  • 既に置換処理が実装されている場合は改修不要です。
  • モバイルのSHA-2化について詳細はこちらをご覧ください。

    (2015/1/27 追加)
    モバイル版でプロフィール画像をSSL表示したい場合は、People API(thumbnailUrl)で取得したURLを以下のようにドメイン置換してご利用ください。
    (モバイルのみ。PC・スマートフォンではSSL環境でもドメイン置換不要です)

    
    https://profile.img.mixi.jp/photo/~  →  https://secure.m.mixi.jp/photo/~
    

    置換結果

    
    180×180:  https://secure.m.mixi.jp/photo/member/{id1}/{id2}/{id3}.jpg
    76×76  :  https://secure.m.mixi.jp/photo/member/{id1}/{id2}/{id3}s.jpg
    40×40  :  https://secure.m.mixi.jp/photo/member/{id1}/{id2}/{id3}m.jpg
    

    「NO IMAGE」画像のURL

    もし画像がユーザーによって登録されていなかった場合は、People API(thumbnailUrl)では以下の「NO IMAGE」画像を提供します。
    この画像も3種類の大きさがあります。

    180×180:  http://img.mixi.net/img/basic/common/noimage_member180.gif
    76×76  :  http://img.mixi.net/img/basic/common/noimage_member76.gif
    40×40  :  http://img.mixi.net/img/basic/common/noimage_member40.gif
    

    People API(thumbnailUrl)にて取得されるURLは、76×76の大きさのURLとなります。他の大きさの「NO IMAGE」画像のURLは、上記のそれぞれのURLを利用することで得ることが可能です。

    (2016/10/24 追加)
    プロフィール画像と同じ理由により、以下のモバイル版での置換作業は不要となります。

    (2015/1/27 追加)
    モバイル版で「NO IMAGE」画像をSSL表示したい場合は、People API(thumbnailUrl)で取得したURLを以下のようにドメイン置換してご利用ください。
    (モバイルのみ。PC・スマートフォンではSSL環境でもドメイン置換不要です)

    
    https://img.mixi.net/img/~  →  https://secure.m.mixi.jp/img/~
    

    置換結果

    
    180×180:  https://secure.m.mixi.jp/img/basic/common/noimage_member180.gif
    76×76  :  https://secure.m.mixi.jp/img/basic/common/noimage_member76.gif
    40×40  :  https://secure.m.mixi.jp/img/basic/common/noimage_member40.gif
    
  • このページの上部へ