Emiri::Netについて

Emiri::Netはeimri7APIを利用するPerlモジュールです
[download]
1.アルバムデータの取得
2.日記データの取得


アルバムデータの取得:

use Emiri::Net;      
my $api = Emiri::Net->new(id=>'',[[pkey=>''],[akey=>'']],[host=>'',[path='']]);        
my $albums = $api->getAlbum([year=>0000,month=>00,day=>00][pos=0]); 
foreach my $album (@$albums){       
	my $img = $api->getImage($album,[size=>''],[type=>''],[download=>1,baes64]);   
}  #[ ]は任意項目を指す

        

new()
id:日記のID 必須
pkey:日記のパスワードでパスワードの平文かmd5_hex(id,passwd)したもの。日記にアクセスキーとワンタイムパスワードが設定されている場合必須
akey:日記のアクセスキーの平文かmd5_hex(id,access_key)したもの。日記にアクセスキーが設定されている場合必須
host:接続先ホスト デフォルトはemiripapas.com
path:接続先CGIのパス デフォルトは/cgi-bin/emiri
返り値:Emiri::Netオブジェクト

getAlbum()
year,month,day:アルバムの日付。yearのみの場合はその年からランダム、year,monthの指定の場合はその月からランダム,year,month,dayの指定がある場合はpos番目のアルバム pos:year,month,dayを指定したときにpos番目のアルバム。デフォルトは0(先頭)。 返り値:アルバムのハッシュの配列の参照 一つだけの場合も要素数1の配列として返す。ハッシュキーとその値は以下。
key説明
id 日記のID emiri
memo 写真のキャプション
num 同じ日付に含まれるアルバムの全枚数 5
day YYYY-MM-DD形式の日付 2008-07-04
ctime YYYY-MM-DD HH:MM::SS形式のこの日記が書かれた日時 2008-07-04 01:15:18
mtime YYYY-MM-DD HH:MM::SS形式のこの日記が修正された日時 2008-07-04 01:15:18
base この日記の画像が置かれているディレクトリ /emiri/home/emiri/data/2008/200807
pict この日記の画像ファイル名の基本部分 20080703-2a0625e8f9bd6c6b
pict_type 0:通常の画像 1:ムービー 20080703-2a0625e8f9bd6c6b
error アルバムを取得できなかったときのメッセージ Invalid Access Permission denied

getImage()
album:getAlbum()が返したハッシュの参照
size:画像のサイズを示すニーモニック org=>元画像 large=>標準画像 medium=>サムネール small=>極小サムネール をそれぞれ指す
type:画像タイプ jpeg,gif,png,flvが選択可能 ただしflvが選択できるのはpict_type=1の場合のみ。
なおすべてのサイズのすべての画像タイプが用意されている訳ではないので、emiri7のAPIについてのページを参照のこと。
download:返り値の欄を参照
返り値:downloadの指定がない場合は画像のURL、download=>1の場合は対象画像をバイナリデータ、download=>'base64'の場合は対象画像のバイナリデータをbase64エンコードしたもの


日記データの取得:

use Emiri::Net;      
my $api = Emiri::Net->new(id=>'',[[pkey=>''],[akey=>'']],[host=>'',[path='']]);        
my $diary = $api->getDiary([year=>0000,month=>00,day=>00]);     
my $img = $api->getImage(diary,[size=>''],[type=>''],[download=>1,baes64);   #[ ]は任意項目を指す
        

new()
id:日記のID 必須
pkey:日記のパスワードでパスワードの平文かmd5_hex(id,passwd)したもの。日記にアクセスキーとワンタイムパスワードが設定されている場合必須
akey:日記のアクセスキーの平文かmd5_hex(id,access_key)したもの。日記にアクセスキーが設定されている場合必須
host:接続先ホスト デフォルトはemiripapas.com
path:接続先CGIのパス デフォルトは/cgi-bin/emiri
返り値:Emiri::Netオブジェクト

getDiary()
year,month,day:日記の日付。yearのみの場合はその年からランダム、year,monthの指定の場合はその月からランダム,year,month,dayの指定がある場合はその日の日記 返り値:日記のデータが収まったハッシュの参照。
key説明
id 日記のID emiri
title 日記のタイトル
memo 日記の本文
memo 日記の天気 n:未記入 f:晴れ c:曇 r:雨 s:雪 b:後 s:時々をデリミター/で区切って表示 r/b/f:雨のち晴れ
f/s/c:晴れ時々曇り
f/n/n:晴れ
day YYYY-MM-DD形式の日付 2008-07-04
ctime YYYY-MM-DD HH:MM::SS形式のこの日記が書かれた日時 2008-07-04 01:15:18
mtime YYYY-MM-DD HH:MM::SS形式のこの日記が修正された日時 2008-07-04 01:15:18
base この日記の画像が置かれているディレクトリ /emiri/home/emiri/data/2008/200807
pict この日記の画像ファイル名の基本部分 20080703-2a0625e8f9bd6c6b
error 日記を取得できなかったときのメッセージ Invalid Access Permission denied

getImage()
album:getAlbum()が返したハッシュの参照
size:画像のサイズを示すニーモニック org=>元画像 large=>標準画像 medium=>サムネール small=>極小サムネール をそれぞれ指す
type:画像タイプ jpeg,gif,pngが選択可能 br> なおすべてのサイズのすべての画像タイプが用意されている訳ではないので、emiri7のAPIについてのページを参照のこと。
download:返り値の欄を参照
返り値:downloadの指定がない場合は画像のURL、download=>1の場合は対象画像をバイナリデータ、download=>'base64'の場合は対象画像のバイナリデータをbase64エンコードしたもの