ヘルプ

フォト蔵API

photo_info APIメソッド

JSON: https://api.photozou.jp/rest/photo_info.json
 XML: https://api.photozou.jp/rest/photo_info.xml

概要

インターネットに公開されている写真の詳細情報を取得します。

認証

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

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

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

パラメータ

photo_id(必須)
写真ID
private
'true' にすると、非公開アルバムの写真の情報も取得できます。(認証が必要になります)

JSONレスポンス

{
  "info": {
    "photo": {
      "photo_id": ###,
      "user_id": ###,
      "album_id": ###,
      "photo_title": "タイトル",
      "description": "写真の説明",
      "favorite_num": ###,
      "comment_num": ###,
      "view_num": ###,
      "copyright": "normal/creativecommons",
      "copyright_commercial": "yes/no"
      "copyright_modifications": "yes/no/share"
      "original_height": ##,
      "original_width": ###,
      "geo": {
          "latitude": ###,
          "longitude": ###
      },
      "date": "YYYY-MM-DD",
      "regist_time": "YYYY-MM-DDThh:mm:ss+09:00",
      "url": "URL",
      "image_url": "URL",
      "original_image_url": "URL",
      "thumbnail_image_url": "URL",
      "tags": [
        "タグ1",
        "タグ2",
        ...
      ],
      "large_tag": "<a href=\"...\">...</a>",
      "medium_tag": "<a href=\"...\">...</a>"
    }
  }
}

XMLレスポンス

<info>
  <photo>
    <photo_id>###</photo_id>
    <user_id>###</user_id>
    <album_id>###</album_id>
    <photo_title>タイトル</photo_title>
    <description>説明</description>
    <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>
    <geo>
      <latitude>###</latitude>
      <longitude>###</longitude>
    </geo>
    <date>YYYY-MM-DD</date>
    <regist_time>YYYY-MM-DDThh:mm:ss+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>
</info>

レスポンスの説明

photo_id
写真ID
user_id
ユーザーID
album_id
アルバムID
photo_title
タイトル
description
説明
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'の場合は他の人が同一条件化で配付する場合のみ変更を許可します。
geo
写真の位置情報(ある場合)
date
撮影日
regist_time
登録日時(W3C Date and Time Formats による書式)
tags
関連づけられているタグ
url
写真ページのURL
image_url
画像のURL
original_image_url
オリジナル画像のURL(写真のみ)
thumbnail_image_url
サムネイル画像のURL
large_tag
ブログ等に貼り付けるためのHTMLコード(普通サイズ)、XMLではCDATAで囲まれています。
medium_tag
ブログ等に貼り付けるためのHTMLコード(縮小サイズ)、XMLではCDATAで囲まれています。