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

mixiアプリ

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

URLのルール

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

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

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

プロフィール画面のURL

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

  • PC向け:
    http://mixi.jp/show_friend.pl?puid={user_id}
  • 携帯端末向け:
    http://m.mixi.jp/show_friend.pl?puid={user_id}

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

プロフィール画像のURL

ユーザーのプロフィール画像は、Person & Friends API(THUMBNAIL_URL)を利用することで取得できます。
大きさは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

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

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

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

(2015/1/27 追加)
モバイル版でプロフィール画像をSSL表示したい場合は、Person & Friends API(THUMBNAIL_URL)で取得した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

もし画像がユーザーによって登録されていなかった場合は、Person & Friends API(THUMBNAIL_URL)では以下の「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

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

(2015/1/27 追加)
モバイル版で「NO IMAGE」画像をSSL表示したい場合は、Person & Friends API(THUMBNAIL_URL)で取得した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

このページの上部へ