1.日記のデータを取得する
2.アルバムのデータを取得する
3.アルバム中の一つのデータを取得する
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 | | ○ | | |
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 | | ○ | | | |
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をもとにした画像パスの入手、および実際に存在する画像については、アルバムのデータを取得すると同じです。 |