emiri7 APIについて

1.日記のデータを取得する
2.アルバムのデータを取得する
3.アルバム中の一つのデータを取得する


1.日記のデータを取得する

Request形式:

http://emiripapas.com/cgi-bin/emiri/Diary.cgi
名前説明
base 日記のID ※必須 base=emiri
type 返り値形式の指定 type=json 
※必須(現在json以外の指定はできない)
type=json
akey 日記のアクセスキーかアクセスキーを日記のIDでMD5ハッシュしたもの
※アクセスキーが設定されている場合必須
akey=aaaa akey=e19f01fce9f
pkey 日記のパスワードかパスワードを日記のIDでMD5ハッシュしたもの
※アクセスキーとワンタイムパスワードが設定されている場合必須
akey=aaaa akey=e19f01fce9f
year 日記の年 year=2007
month 日記の月 month=4
day 日記の日 day=8
rand rand=nのときyear,monthの指定があればその月からランダムにn日、yearの指定があればその年からランダムにn日、year,monthの指定がない場合は全体からランダムにn日の写真有りの日記を取得. nの最大値には365日.
rand=pictはrand=1の場合と同じ
rand=は、写真の有る無しに関わらずランダムに1日だけ日記を取り出す
このAPIは、2010.3に仕様を変更しました。
rand=4

Response形式:

JSON形式の場合:次のキーを用いたJSONハッシュで値が返る。文字コードはUTF-8。
key説明
id 日記のID emiri
title 日記のタイトル
memo 日記の本文
weather 日記の天気 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

JSONの例:

        {
          'base' => '/emiri/home/emirisys/data/2008/200807',
          'ctime' => '2008-07-03 01:13:52',
          'mtime' => '2008-07-03 01:13:52',
          'memo' => '',
          'weather' => 'n/n/n',
          'day' => '2008-07-03',
          'pict' => '20080703-2a06aa558f9bd6c6b',
          'title' => '',
          'id' => 'emirisys'
        };
        

baseとpictをもとにした画像パスの入手方法:

画像のパスは、 http://emiripapas.com{BASE}/{PREFIX}{PICT}{SUFFIX}となる。
{BASE}baseの値
{PICT}pictの値
{PREFIX} ''(空文字):標準の画像
T:横幅150pxのサムネール画像
ST:横幅30pxのサムネール画像
{SUFFIX} _org.jpg:写真のオリジナル画像
.jpg:JPEG画像
.gif:GIF画像
.png:PNG画像

PREFIXとSUFFIXの組み合わせによる実際に画像が存在している範囲

PREFIX/SUFFIX_org.jpg.jpg.gif.png
空文字
T
ST


2.アルバムのデータを取得する

Request形式:

http://emiripapas.com/cgi-bin/emiri/Album.cgi
名前説明
base 日記のID ※必須 base=emiri
type 返り値形式の指定 type=json 
※必須(現在json以外の指定はできない)
type=json
akey 日記のアクセスキーかアクセスキーを日記のIDでMD5ハッシュしたもの
※アクセスキーが設定されている場合必須
akey=aaaa akey=e19f01fce9f
pkey 日記のパスワードかパスワードを日記のIDでMD5ハッシュしたもの
※アクセスキーとワンタイムパスワードが設定されている場合必須
akey=aaaa akey=e19f01fce9f
year 日記の年 year=2007
month 日記の月 month=4
day 日記の日 day=8

Response形式:

JSON形式の場合:次のキーを用いたJSONハッシュの配列が返る。文字コードはUTF-8。 例えばその日の日記に3枚のが画像がある場合3つのハッシュの配列が返る。
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

JSONの例:

      [
          {
            'base' => '/emiri/home/emirisys/data/2008/200807/20080715',
            'ctime' => '2008-07-17 23:25:48',
            'num' => 5,
            'mtime' => '2008-07-17 23:25:48',
            'memo' => '',
            'pict_type' => '0',
            'day' => '2008-07-15',
            'id' => 'emirisys',
            'pict' => '20080715-bab20f6555ca3ce5'
          },
          {
            'base' => '/emiri/home/emirisys/data/2008/200807/20080715',
            'ctime' => '2008-07-17 23:25:57',
            'num' => 5,
            'mtime' => '2008-07-17 23:25:57',
            'memo' => '',
            'pict_type' => '0',
            'day' => '2008-07-15',
            'id' => 'emirisys',
            'pict' => '20080715-79142ffff121e452'
          },
          {
            'base' => '/emiri/home/emirisys/data/2008/200807/20080715',
            'ctime' => '2008-07-18 00:23:38',
            'num' => 5,
            'mtime' => '2008-07-18 00:23:38',
            'memo' => '',
            'pict_type' => '0',
            'day' => '2008-07-15',
            'id' => 'emirisys',
            'pict' => '20080715-9d794836sss651e5'
          }
        ];

        

baseとpictをもとにした画像パスの入手方法:

画像のパスは、 http://emiripapas.com{BASE}/{PREFIX}{PICT}{SUFFIX}となる。
{BASE}baseの値
{PICT}pictの値
{PREFIX} ''(空文字):標準の画像
T:横幅150pxのサムネール画像
ST:横幅30pxのサムネール画像
{SUFFIX} _org.jpg:写真のオリジナル画像
.jpg:JPEG画像
.gif:GIF画像
.png:PNG画像

通常画像(pict_type=0)の場合のPREFIXとSUFFIXの組み合わせによる実際に画像が存在している範囲

PREFIX/SUFFIX_org.jpg.jpg.gif.png.flv
空文字
T
ST

ムービー(pict_type=1)の場合のPREFIXとSUFFIXの組み合わせによる実際に画像が存在している範囲

PREFIX/SUFFIX_org.jpg.jpg.gif.png.flv
空文字
T
ST


3.アルバム中の一つのデータを取得する

Request形式:

http://emiripapas.com/cgi-bin/emiri/Slide.cgi
名前説明
base 日記のID ※必須 base=emiri
type 返り値形式の指定 type=json 
※必須(現在json以外の指定はできない)
type=json
akey 日記のアクセスキーかアクセスキーを日記のIDでMD5ハッシュしたもの
※アクセスキーが設定されている場合必須
akey=aaaa akey=e19f01fce9f
pkey 日記のパスワードかパスワードを日記のIDでMD5ハッシュしたもの
※アクセスキーとワンタイムパスワードが設定されている場合必須
akey=aaaa akey=e19f01fce9f
year 日記の年 year=2007
month 日記の月 month=4
day 日記の日 day=8
pos その日のアルバム中のpos番目の写真 デフォルトは0(先頭) pos=1
rand rand=nのときyear,monthの指定があればその月からランダムにn枚、yearの指定があればその年からランダムにn枚、year,monthの指定がない場合は全体からランダムにn枚。
randを指定したときは写真のみ(動画と音源は含まない)。また非公開の写真は含まない。
このAPIは、2010.3に仕様を変更しました。
rand=4

Response形式:

JSON形式の場合:次のキーを用いたJSONハッシュの配列が返る。文字コードはUTF-8。 例えばその日の日記に3枚のが画像がある場合3つのハッシュの配列が返る。
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

JSONの例:

          {
            'base' => '/emiri/home/emirisys/data/2008/200807/20080715',
            'ctime' => '2008-07-17 23:25:48',
            'num' => 5,
            'mtime' => '2008-07-17 23:25:48',
            'memo' => '',
            'pict_type' => '0',
            'day' => '2008-07-15',
            'id' => 'emirisys',
            'pict' => '20080715-bab20f6555ca3ce5'
          }
        

各ハッシュの返り値の中身と、baseとpictをもとにした画像パスの入手、および実際に存在する画像については、アルバムのデータを取得すると同じです。