photo_list_public APIメソッド

フォト蔵API

フォト蔵API

http://api.photozou.jp/rest/photo_list_public

概要

インターネットに公開されている写真の一覧を取得します（最大1000件まで）。

認証

このメソッドは、認証の必要はありません。

サポートされているHTTPメソッド

HTTP GETメソッドのみをサポートしています。

パラメータ

type(必須): 写真一覧の取得
'public', 'everyone', 'album', 'friend', 'popular', 'cc' のいずれかを指定します。
'public': インターネットに公開されている写真の一覧(ユーザーIDの指定が必須となります)
'everyone': インターネットに公開されているすべての人の写真の一覧
'album': 特定のアルバムの写真の一覧(ユーザーIDとアルバムIDの指定が必須となります)
'friend': 指定されたユーザーの友達の写真の一覧(ユーザーIDの指定が必須となります)
'popular': 人気のある写真の一覧
'cc': クリエイティブ・コモンズが設定されている写真の一覧

user_id: ユーザーID
type が public、album、friend のときは必須となります。

album_id: アルバムID
type が album のときは必須となります。

license: クリエイティブ・コモンズの採否を指定します。type が cc のときのみ有効です。
'by': 表示
'by_sa': 表示-継承
'by_nd': 表示-改変禁止
'by_nc': 表示-非営利
'by_nc_sa': 表示-非営利-継承
'by_nc_nd': 表示-非営利-改変禁止

limit: 取得する一覧の上限を指定します。(省略時100件、最大1000件)

レスポンス

<info>
  <photo_num>###</photo_num>
  <photo>
    <photo_id>###</photo_id>
    <user_id>###</user_id>
    <album_id>###</album_id>
    <photo_title>タイトル</photo_title>
    <favorite_num>###</favorite_num>
    <comment_num>###</comment_num>
    <view_num>###</view_num>
    <copyright>normal/creativecommons</copyright>
    <copyright_commercial>yes/no</copyright_commercial>
    <copyright_modifications>yes/no/share</copyright_modifications>
    <date>2006-05-07</date>
    <regist_time>2006-05-07T02:14:47+09:00</regist_time>
    <tags>
      <tag>タグ</tag>
      <tag>タグ</tag>
      ...
    </tags>
    <url>URL</url>
    <image_url>URL</image_url>
    <original_image_url>URL</original_image_url>
    <thumbnail_image_url>URL</thumbnail_image_url>
    <large_tag><![CDATA[..........]]></large_tag>
    <medium_tag><![CDATA[.........]]></medium_tag>
  </photo>
  <photo>
    ...
  </photo>
  ...
</info>

photo_num: 写真の数

photo_id: 写真ID

user_id: ユーザーID

album_id: アルバムID

photo_title: タイトル

favorite_num: お気に入り数

comment_num: コメント数

view_num: アクセス数

copyright: ライセンスの型(normal: ライセンスなし、または creativecommons: クリエイティブ・コモンズ)

copyright_commercial: クリエイティブ・コモンズによる著作権、営利目的での利用を指定します。
'yes'(デフォルト), 'no'の2種類を指定できます。
'yes'の場合は利用を許可、'no'の場合は利用を許可しません。

copyright_modifications: クリエイティブ・コモンズによる著作権、改変の許可を指定します。 ('copyright'パラメータに'creativecommons'を指定したときのみ有効)
'yes'(デフォルト), 'no', 'share'の3種類を指定できます。
'yes'の場合は改変を許可、'no'の場合は改変を許可しません。
'share'の場合は他の人が同一条件化で配付する場合のみ変更を許可します。