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

mixi Connect

mixi Connect » mixi Graph API » 技術仕様 » Photo API

Photo API

ユーザがmixi上でコミュニケーションを楽しむためのコンテンツとして、フォトは非常に重要です。フォトには、そのユーザの想い出や感情が詰まっています。多くのユーザが、手軽にフォトをmixiに登録し、友人とシェアをしたいと考えています。写真を撮影してすぐにmixiに登録したい、この願いをPhoto APIは叶えてくれます。

ここでは、Photo APIの使用方法について説明します。

 

事前に必要なもの

Photo APIを利用するためには、以下の情報をすでに入手している必要があります。

  • “r_photo”または”w_photo”スコープおよびその両方について認可されたアクセストークン

上記以外のスコープで認可されたアクセストークンを使用して、Photo APIにアクセスすることはできません。アクセストークンの入手方法については、認証認可手順のページをご覧ください。

Photo APIで提供される機能とスコープ

Photo APIでは様々な機能が提供されますが、それらは大きく「参照系」「投稿系」の2つに分類されます。この分類は、そのままPhoto APIを利用するためのスコープに対応します。以下に、スコープと各機能の対応を示します。

スコープ 機能
r_photo アルバム一覧の取得
フォト一覧の取得
アルバムへのコメント一覧取得
フォトへのコメント一覧取得
フォトへのイイネ一覧取得
w_photo アルバムの作成
アルバムの削除
フォトの追加
フォトの削除
アルバムへのコメント投稿、削除
フォトへのコメント投稿、削除
フォトへのイイネ投稿、削除

アルバム一覧の取得

アルバム一覧を取得するためのURIは以下となります。

GET https://api.mixi-platform.com/2/photo/albums/[User-ID]/@self/[Album-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、または友人のユーザID。
Album-ID あるアルバムのID。これを指定した場合は、API呼び出しの結果として、そのアルバムの情報のみが返却されます。省略可。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

アルバム情報の取得結果は、以下のようになります。下記の例は、JSON形式です。

{
  "entry": [
    {
      "created": "2010-11-02T10:42:57+09:00",
      "description": "アルバムの説明",
      "id": "123456",
      "mediaItemCount": "200",
      "numComments": "5",
      "ownerId": "7dshdjk3mbc3w",
      "privacy": {
        "visibility": "everyone"
      },
      "thumbnailUrl": "http://ic.photo.mixi.jp/v/fbf9659ba91f6495ee9619819954a20f2476b306cd/4cd2176e/picture/u7dshdjk3mbc4x_119876_74small.jpg",
      "title": "アルバムのタイトル",
      "url": "http://ic.photo.mixi.jp/v/838166e4701d0b43874b9050d2e593e0e29d9aa87e/4cd2176e/picture/u7dshdjk3mbc4x_119876_74large.jpg",
      "viewPageUrl": "http://mixi.jp/redirect_with_owner_id.pl?b=http%3A%2F%2Fphoto.mixi.jp%3A8150%2Fview_album.pl%3Falbum_id%3D111377&k=owner_id&v=7dshdjk3mbc3w",
      "owner": {
  	"thumbnailUrl":"http://profile.img.mixi.jp/photo/user/7dshdjk3mbc3w_15647919.jpg",
  	"id":"7dshdjk3mbc3w",
  	"displayName":"jack",
  	"profileUrl":"http://mixi.jp/redirect_friend_api.pl?puid=xxxxxxxxxxxxx&client_id=xxxxxxxx;
      }
    },
    ・・・
  ],
  ・・・
}

個々のエントリに含まれる情報は、以下となります。

属性名 説明
id アルバムを特定するためのID
thumbnailUrl アルバムのサムネイル画像のURL
title アルバムのタイトル文字列
description アルバムの説明文。
ownerId このアルバムを所有するユーザのID
created このアルバムが作成された日時
mediaItemCount このアルバムに登録されているフォトの枚数
url このアルバムを表す大きめの画像のURL
numComments このアルバムにつけられたコメントの件数
privacy このアルバムの公開範囲
viewPageUrl このアルバムのページのURL(view_album.pl、もし簡単公開アルバム@defaultの場合はview_default_album.pl)
owner.id オーナーのID
owner.displayName オーナーのニックネーム
owner.thumbnailUrl オーナーがプロフィール画像として設定しているイメージのURL
owner.profileUrl オーナーのプロフィルページのURL

かんたん公開アルバムについて

mixiフォトでは、写真を簡単に公開するために最初から各ユーザ向けに「かんたん公開」アルバムが提供されています。これは全ユーザが所有しているアルバムであり、削除や名称変更などはできません。

Photo APIを利用して、Album-IDの指定なしにアルバム一覧情報を取得した際には、その取得結果の中に「かんたん公開」アルバムの情報は含まれません。「かんたん公開」アルバムのIDは”@default“となりますので、各機能の中でクライアントプログラム側が「かんたん公開」アルバムに”@default”を使用して対応してください。

“privacy” パラメーターの形式

そのアルバムの公開範囲は、privacyパラメータ値で得られます。このprivacyパラメータは、更にvisibilityパラメータを持ちます。公開範囲の種別は、visibilityパラメータ値により表現されます。

visibilityパラメータ値の一覧は以下となります。

指定値 意味
everyone 全体に公開
friends 友人まで公開
friends_of_friends 友人の友人まで公開
top_friends 仲良しに公開
group 特定のグループにのみ公開
user 特定のユーザにのみ公開
access_key 合言葉にして公開
self 非公開

最近友人が作成したアルバム一覧の取得

友人が最近作成したアルバムの一覧を取得するためのURIは以下となります。

GET https://api.mixi-platform.com/2/photo/albums/[User-ID]/[Group-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザIDまたは認可ユーザ自身を示す”@me”。
Group-ID “@friends”、またはGroups APIで取得できるグループのID。

取得結果は通常のアルバム一覧取得時と同様の形式です。

Group-IDとして”@friends”を指定した場合は、友人が最近作成したアルバムの一覧が取得できます。
Groups APIで取得できるidを指定することで、そのグループに所属している友人のみに限定することが可能です。

フォト一覧の取得

あるアルバムに登録されているフォトの一覧を取得するためのURIは以下となります。

GET https://api.mixi-platform.com/2/photo/mediaItems/[User-ID]/@self/[Album-ID]/[MediaItem-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、または友人のユーザID。
Album-ID フォト一覧を取得したいアルバムのID。友人のかんたん公開アルバムを指定したい場合は、”@default”をパラメータ値とします。
MediaItem-ID あるフォトのID。これを指定した場合は、API呼び出しの結果として、そのフォトの情報のみが返却されます。省略可。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

フォト情報の取得結果は、以下のようになります。下記の例は、JSON形式です。

{
  "entry": [
    {
      "albumId": "99465",
      "created": "2010-11-01T12:04:49+09:00",
      "id": "117676",
      "largeImageUrl": "http://ic.photo.mixi.jp/v/fffd76a06cf4275c267257b96eb1c2c3c06bf8e25b/4cd21765/picture/u7dshdjk3mbc4x_117676_65xga.jpg",
      "mimeType": "image/jpeg",
      "numComments": "0",
      "numFavorites": "0",
      "thumbnailUrl": "http://ic.photo.mixi.jp/v/8684fa2911a044f9de932f6ee7f00f5d46ade867c8/4cd21765/picture/u7dshdjk3mbc4x_117676_65small.jpg",
      "title": "ふぁー",
      "type": "IMAGE",
      "url": "http://ic.photo.mixi.jp/v/8e0e2ab248dc82fe8bf016d7bb361f6117ab0cec5f/4cd21765/picture/u7dshdjk3mbc4x_117676_65large.jpg",
      "viewPageUrl": "http://mixi.jp/redirect_with_owner_id.pl?b=http%3A%2F%2Fphoto.mixi.jp%3A8150%2Fview_photo.pl%3Fphoto_id%3D117676&k=owner_id&v=7dshdjk3mbc4x",
      "owner": {
  	"thumbnailUrl":"http://profile.img.mixi.jp/photo/user/7dshdjk3mbc3w_15647919.jpg",
  	"id":"7dshdjk3mbc3w",
  	"displayName":"jack",
  	"profileUrl":"http://mixi.jp/redirect_friend_api.pl?puid=xxxxxxxxxxxxx&client_id=xxxxxxxx;
      }
    },
    ・・・
  ],
  ・・・
}

個々のエントリに含まれる情報は、以下となります。

属性名 説明
albumId アルバムのID
created このフォトがアップロードされた日時
id このフォトを特定するためのID
mimeType このフォトのMIME type
numComments このフォトにつけられたコメントの件数
title このフォトのタイトル文字列
type “IMAGE”固定
thumbnailUrl このフォトのサムネイル画像のURL
numFavorites このフォトにつけられたイイネ!の件数
url このフォトの大きめの画像のURL
largeImageUrl このフォトのXGAサイズの画像のURL
exifCreated このフォトの撮影日
viewPageUrl このフォトのページのURL(view_photo.pl)
owner.id オーナーのID
owner.displayName オーナーのニックネーム
owner.thumbnailUrl オーナーがプロフィール画像として設定しているイメージのURL
owner.profileUrl オーナーのプロフィルページのURL

最近友人がアップロードしたフォト一覧の取得

友人が最近アップロードしたフォトの一覧を取得するためのURIは以下となります。

GET https://api.mixi-platform.com/2/photo/mediaItems/[User-ID]/[Group-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザIDまたは認可ユーザ自身を示す”@me”。
Group-ID “@friends”、またはGroups APIで取得できるグループのID。

取得結果は通常のフォト一覧取得時と同様の形式です。

Group-IDとして”@friends”を指定した場合は、友人が最近投稿したフォトの一覧が取得できます。
Groups APIで取得できるidを指定することで、そのグループに所属している友人のみに限定することが可能です。

友人が複数枚のフォトをまとめてアップロードしていた場合、このAPIで取得できるフォトはそのうちの
1枚の情報のみとなります。

アルバムへのコメント一覧の取得

アルバムに対して付けられたコメントの一覧を取得するためのURIは以下となります。

GET https://api.mixi-platform.com/2/photo/comments/albums/[User-ID]/@self/[Album-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、または友人のユーザID。
Album-ID コメント一覧を取得したいアルバムのID。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

取得結果は、以下のようなJSON形式となります。

{
    "entry" : [
        "id" : "sa1pzkdg9emdd-500000004743798-sa1pzkdg9emdd-20101208110507",
        "created" : "2010-12-08T11:07:38+09:00",
        "text" : "コメント本文",
        "user" : [
            "id" : "sa1pzkdg9emdd",
            "displayName" : "ニックネーム",
            "thumbnailUrl" : "http://profile.img.mixi.jp/photo/user/sa1pzkdg9emde_156479.jpg",
            "profileUrl" : "http://mixi.jp/redirect_friend_api.pl?puid=xxxxxxxxxxxxx&client_id=xxxxxxxx;
        ]
    ],
    ・・・
}

個々のエントリに含まれる情報は、以下となります。

属性名 説明
id コメントを特定するためのID (Comment-ID)
created コメントがされた日時。日時の書式は「yyyy-mm-ddThh:mm:ss+09:00」となります(詳しくは[XSdateTime]を参照)。
text コメントの本文。
user.id コメント投稿者のユーザID。
user.displayName コメント投稿者のニックネーム。
user.thumbnailUrl コメント投稿者のプロフィール画像のURL。
user.profileUrl コメント投稿者のプロフィールページのURL。

userプロパティにて表現されるコメント投稿者が認可ユーザと友人関係ではない場合は、id、displayNameおよびthumbnailUrlプロパティのみが結果に含まれます。

フォトへのコメント一覧の取得

フォトに対して付けられたコメントの一覧を取得するためのURIは以下となります。

GET https://api.mixi-platform.com/2/photo/comments/mediaItems/[User-ID]/@self/[Album-ID]/[MediaItem-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、または友人のユーザID。
Album-ID コメント一覧を取得したいアルバムのID。友人のかんたん公開アルバムを指定したい場合は、”@default”をパラメータ値とします。
MediaItem-ID コメント一覧を取得したいフォトのID。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

取得結果は、以下のようなJSON形式となります。

{
    "entry" : [
        "id" : "sa1pzkdg9emdd-500000004743798-sa1pzkdg9emdd-20101208110507",
        "created" : "2010-12-08T11:07:38+09:00",
        "text" : "コメント本文",
        "user" : [
            "id" : "sa1pzkdg9emdd",
            "displayName" : "ニックネーム",
            "thumbnailUrl" : "http://profile.img.mixi.jp/photo/user/sa1pzkdg9emde_156479.jpg",
            "profileUrl" : "http://mixi.jp/redirect_friend_api.pl?puid=xxxxxxxxxxxxx&client_id=xxxxxxxx;
        ]
    ],
    ・・・
}

個々のエントリに含まれる情報は、以下となります。

属性名 説明
id コメントを特定するためのID (Comment-ID)
created コメントがされた日時。日時の書式は「yyyy-mm-ddThh:mm:ss+09:00」となります(詳しくは[XSdateTime]を参照)。
text コメントの本文。
user.id コメント投稿者のユーザID。
user.displayName コメント投稿者のニックネーム。
user.thumbnailUrl コメント投稿者のプロフィール画像のURL。
user.profileUrl コメント投稿者のプロフィールページのURL。

userプロパティにて表現されるコメント投稿者が認可ユーザと友人関係ではない場合は、id、displayNameおよびthumbnailUrlプロパティのみが結果に含まれます。

フォトへのイイネ一覧の取得

フォトに対して付けられたイイネの一覧を取得するためのURIは以下となります。

GET https://api.mixi-platform.com/2/photo/favorites/mediaItems/[User-ID]/@self/[Album-ID]/[MediaItem-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、または友人のユーザID。
Album-ID イイネ一覧を取得したいアルバムのID。友人のかんたん公開アルバムを指定したい場合は、”@default”をパラメータ値とします。
MediaItem-ID イイネ一覧を取得したいフォトのID。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

取得結果は、以下のようなJSON形式となります。

{
    "entry" : [
        {
            "id" : "sa1pzkdg9emdd",
            "displayName" : "ニックネーム",
            "thumbnailUrl" : "http://profile.img.mixi.jp/photo/user/sa1pzkdg9emde_156479.jpg",
            "profileUrl" : "http://mixi.jp/redirect_friend_api.pl?puid=xxxxxxxxxxxxx&client_id=xxxxxxxx;,
            "created" : "2010-11-02T10:42:57+09:00"
        },
        ・・・
    ],
    ・・・
}

個々のエントリに含まれる情報は、以下となります。

属性名 説明
id イイネ投稿者のユーザID。
displayName イイネ投稿者のニックネーム。
thumbnailUrl イイネ投稿者のプロフィール画像のURL。
profileUrl イイネ投稿者のプロフィールページのURL。
created イイネが投稿された日時。日時の書式は「yyyy-mm-ddThh:mm:ss+09:00」となります(詳しくは[XSdateTime]を参照)。

イイネ投稿者が認可ユーザと友人関係ではない場合は、id、displayNameおよびthumbnailUrlプロパティのみが結果に含まれます。

アルバムの作成

新規にアルバムを作成するためのURIは以下となります。

POST https://api.mixi-platform.com/2/photo/albums/[User-ID]/@self
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、もしくは認可ユーザ自身を示す”@me”

User-IDパラメータとして指定可能なIDは、アクセストークンを認可したユーザ自身を示す”@me”のみとなります。他のユーザのIDあるいは”@friends”などは指定することはできません。

作成するアルバムの情報は、リクエストボディに「x-www-form-urlencoded」形式または「application/json」形式のどちらかで指定します。この際、Content-Typeリクエストヘッダにて、どちらの形式を使用したかを明示する必要があります。文字コードはUTF-8を使用してください。指定可能な情報は以下となります。

パラメータ名 説明 必須
title アルバムのタイトル文字列
description アルバムの説明文
visibility アルバムの公開範囲指定
accessKey アルバムの閲覧制限を行うための合言葉 visibilityパラメータに”access_key”が指定された場合にのみ必須

visibilityパラメータで指定可能な公開範囲は、以下となります。

指定値 意味
everyone 全体に公開
friends 友人まで公開
friends_of_friends 友人の友人まで公開
top_friends 仲良しに公開
access_key 合言葉にして公開
self 非公開

「x-www-form-urlencoded」形式での指定は、以下のようになります。

title=タイトル&description=説明&visibility=everyone

「application/json」形式での指定は、以下のようになります。

{
  "title" : "タイトル",
  "description" : "説明",
  "privacy" : {
      "visibility" : "access_key",
      "accessKey" : "secret"
  }
}

新規アルバムの作成に成功した場合は、HTTPステータスコード201および以下の内容がレスポンスボディとして返却されます。

{
  "id" : [Album-ID]
}

これで返却されるAlbum-IDにより、作成されたアルバムにアクセスすることができるようになります。

アルバムの削除

あるアルバムを削除したい時には以下のURIを使用します。

DELETE https://api.mixi-platform.com/2/photo/albums/[User-ID]/@self/[Album-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、もしくは認可ユーザ自身を示す”@me”
Album-ID 削除したいアルバムのID

User-IDパラメータとして指定可能なIDは、アクセストークンを認可したユーザのID、もしくは認可ユーザ自身を示す”@me”のみとなります。他のユーザのIDあるいは”@friends”などは指定することはできません。

削除に成功した場合は、HTTPステータスコード200が返却されます。そのアルバムに登録されていたフォトも同時に削除されます。

アルバムへのコメント投稿

あるアルバムへのコメントの投稿を行うためのURIは以下となります。

POST https://api.mixi-platform.com/2/photo/comments/albums/[User-ID]/@self/[Album-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、もしくは友人のユーザID
Album-ID コメントを投稿したいアルバムのID。かんたん公開アルバムを示す”@default”は指定不可。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

コメント本文は、application/jsonもしくはapplication/x-www-form-urlencodedのどちらかの形式でリクエストボディに指定します。この際、Content-Typeリクエストヘッダにて、どちらの形式を利用したかを指定します。

application/json形式の場合は、以下のようになります。

{
    "text" : "コメント本文"
}

application/x-www-form-urlencoded形式の場合は、以下のようになります。

text=%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88%E6%9C%AC%E6%96%87

コメントの投稿に成功した場合は、HTTPステータスコードとして201が返却されます。

アルバムへのコメントの削除

あるアルバムに投稿されたコメントを削除するためのURIは以下となります。

DELETE https://api.mixi-platform.com/2/photo/comments/albums/[User-ID]/@self/[Album-ID]/[Comment-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、もしくは友人のユーザID
Album-ID 削除したいコメントを持つアルバムのID。かんたん公開アルバムを示す”@default”は指定不可。
Comment-ID 削除したいコメントのID。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

コメントの削除に成功した場合は、HTTPステータスコード200が返却されます。

フォトの追加

あるアルバムにフォトを追加したい場合は以下のURIを使用します。

POST https://api.mixi-platform.com/2/photo/mediaItems/[User-ID]/@self/[Album-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、もしくは認可ユーザ自身を示す”@me”
Album-ID フォトを追加したいアルバムのID
title 登録するフォトのタイトル文字列。省略可。

User-IDパラメータとして指定可能なIDは、アクセストークンを認可したユーザのID、もしくは認可ユーザ自身を示す”@me”のみとなります。他のユーザのIDあるいは”@friends”などは指定することはできません。

追加するフォトのタイトル文字列は、クエリパラメータとしてtitleパラメータ値を指定します。登録する画像ファイルは、リクエストボディとしてそのファイルのバイナリデータを指定します。具体的には、以下のようなリクエストとなります。

POST /2/photo/mediaItems/@me/@self/12345?title=Hello HTTP/1.1
Host: api.mixi-platform.com
Content-Type: image/jpeg
Content-Length: 123456

d84ba376eaaa786249...

フォトの追加に成功した場合は、HTTPステータスコードとして201、およびレスポンスボディに以下の内容が返却されます。

{
  "id" : [MediaItem-ID]
}

これで返却されるMediaItem-IDにより、追加されたフォトにアクセスすることができるようになります。

フォトの削除

あるフォトを削除したい時には以下のURIを使用します。

DELETE https://api.mixi-platform.com/2/photo/mediaItems/[User-ID]/@self/[Album-ID]/[MediaItem-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、もしくは認可ユーザ自身を示す”@me”
Album-ID 削除したいフォトが登録されているアルバムのID
MediaItem-ID 削除したいフォトのID

User-IDパラメータとして指定可能なIDは、アクセストークンを認可したユーザのユーザID、もしくは認可ユーザ自身を示す”@me”のみとなります。他のユーザのIDあるいは”@friends”などは指定することはできません。

削除に成功した場合は、HTTPステータスコード200が返却されます。

フォトへのコメント投稿

あるフォトへのコメントの投稿を行うためのURIは以下となります。

POST https://api.mixi-platform.com/2/photo/comments/mediaItems/[User-ID]/@self/[Album-ID]/[MediaItem-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、もしくは友人のユーザID
Album-ID コメントを投稿したいフォトを持つアルバムのID。
MediaItem-ID コメントを投稿したいフォトのID。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

コメント本文は、application/jsonもしくはapplication/x-www-form-urlencodedのどちらかの形式でリクエストボディに指定します。この際、Content-Typeリクエストヘッダにて、どちらの形式を利用したかを指定します。

application/json形式の場合は、以下のようになります。

{
    "text" : "コメント本文"
}

application/x-www-form-urlencoded形式の場合は、以下のようになります。

text=%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88%E6%9C%AC%E6%96%87

コメントの投稿に成功した場合は、HTTPステータスコードとして201が返却されます。

フォトへのコメントの削除

あるフォトに投稿されたコメントを削除するためのURIは以下となります。

DELETE https://api.mixi-platform.com/2/photo/comments/mediaItems/[User-ID]/@self/[Album-ID]/[MediaItem-ID]/[Comment-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、もしくは友人のユーザID
Album-ID 削除したいコメントを持つフォトのアルバムのID。
MediaItem-ID 削除したいコメントを持つフォトのID。
Comment-ID 削除したいコメントのID。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

コメントの削除に成功した場合は、HTTPステータスコード200が返却されます。

フォトへのイイネ投稿

あるフォトにイイネを投稿するためのURIは以下となります。

POST https://api.mixi-platform.com/2/photo/favorites/mediaItems/[User-ID]/@self/[Album-ID]/[MediaItem-ID]
パラメータ名 指定する値
User-ID 友人のユーザID
Album-ID イイネを投稿したいフォトのアルバムのID。
MediaItem-ID イイネを投稿したいフォトのID。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

投稿に成功した場合は、HTTPステータスコードとして201が返却されます。

フォトへのイイネの削除

あるフォトに投稿されたイイネを削除するためのURIは以下となります。

DELETE https://api.mixi-platform.com/2/photo/favorites/mediaItems/[User-ID]/@self/[Album-ID]/[MediaItem-ID]/[Favorite-User-ID]
パラメータ名 指定する値
User-ID 認可ユーザのユーザID、認可ユーザ自身を示す”@me”、もしくは友人のユーザID
Album-ID 削除したいイイネを持つフォトのアルバムのID。かんたん公開アルバムを示す”@default”は指定不可。
MediaItem-ID 削除したいイイネを持つフォトのID。
Favorite-User-ID 削除したいイイネの投稿者のユーザID。もし対象のフォトの投稿者が認可ユーザだった場合は、そのユーザ以外が投稿したイイネについても削除することが可能。

更に、以下のクエリパラメータをサポートします。

パラメータ名 指定する値
accessKey User-IDに友人を、Album-IDに公開範囲が”合言葉”(visibility=access_key)であるアルバムを指定された場合には、accessKeyパラメータ値としてその合言葉を指定する必要があります。

イイネの削除に成功した場合は、HTTPステータスコード200が返却されます。

ページング、表現形式

Photo APIは、ページングをサポートします。サポートされる表現形式は、JSON形式もしくはx-www-form-urlencoded形式となります。

ページングに関しては、基本的にstartIndex, countパラメータ指定によるものとなりますが、一部next, prevパラメータによる方式が採用されている箇所があります。

文字コードについては、リクエスト時およびレスポンス時の両方において、UTF-8となります。

このページの上部へ