photo_add APIメソッド
http://api.photozou.jp/rest/photo_add
概要
写真を追加します。
データはPOSTメソッドでContent-Typeをすべて小文字で設定して送信する必要があります。データの最大サイズは、写真10MBです。
認証
このメソッドは、認証が必要です。
サポートされているHTTPメソッド
HTTP POSTメソッドのみをサポートしています。
サポートされているContent-Type
画像をアップロードする場合は、次のいずれかを指定します。
- image/gif
- image/jpeg
- image/pjpeg
- image/png
- image/x-png
パラメータ
- photo(必須)
- 写真データ
- album_id(必須)
- アルバムID
- photo_title
- 写真タイトル(最大100文字)
- description
- 写真の説明(最大10000文字)
- tag
- 写真に追加するタグ
※複数のタグを指定する場合は、スペース区切りで指定してください(最大60文字)
- comment
- 写真に追加するコメント(最大600文字)
- date_type
-
'exif'(デフォルト), 'date'の2種類を指定できます。
'exif'を指定すると exif のデータから写真の撮影日を取得します。
'date'を指定した場合は'year', 'month', 'day'の3つのパラメータによって撮影日の指定を行ないます。
- year
- 撮影日の'年'を指定します。
- month
- 撮影日の'月'を指定します。
- day
- 撮影日の'日'を指定します。
レスポンス
<photo_id>xxx</photo_id>
<url>URL</url>
<short_url>Short URL</short_url>
<large_tag><![CDATA[..........]]></large_tag>
<medium_tag><![CDATA[..........]]></medium_tag>
- photo_id
- 登録した写真のIDです
- url
- 写真ページのURL
- short_url
- 写真の短縮URL
- large_tag
- ブログ等に貼り付けるためのHTMLコード(普通サイズ)、CDATAで囲まれています。
- medium_tag
- ブログ等に貼り付けるためのHTMLコード(縮小サイズ)、CDATAで囲まれています。