占いAPI サービス決定版

（1）占いデータの取得

占いデータは http://api.jugemkey.jp/api/horoscope/ に 以下の様な GET リクエストを送ることで取得できます。

GET /api/horoscope/2006/07/22 HTTP/1.1
X-JUGEMKEY-API-CREATED: 2006-07-26T06:55:44Z
X-JUGEMKEY-API-KEY: f6fe8e8481ab91c4785eec03e93c505b
X-JUGEMKEY-API-SIG: 8720df454dd79b9c7acfa3338b35a17273f54472

• X-JUGEMKEY-API-CREATED にはリクエスト時の時刻を W3C Date and Time Formats で指定します。
• X-JUGEMKEY-API-KEY には APIキーを指定します。
• X-JUGEMKEY-API-SIG は APIキーの値, 時刻の順で値のみを文字列連結して、秘密鍵をキーとした HMAC_SHA1 で生成した署名コードです。

（2）データの月日指定方法

占いデータは月単位と日単位で取得することが可能です。月日は以下の様に URL のパスで指定します。

http://api.jugemkey.jp/api/horoscope/year/month/day

以下の URL にリクエストした場合には、2006年7月26日のデータを取得します。

http://api.jugemkey.jp/api/horoscope/2006/07/26

以下の URL にリクエストした場合には、2006年7月の全データを取得します。

http://api.jugemkey.jp/api/horoscope/2006/07

以下の URL にリクエストした場合には、2006年の現在の月の全データを取得します。

http://api.jugemkey.jp/api/horoscope/2006

以下の URL にリクエストした場合には、現在の年月の全データを取得します。

http://api.jugemkey.jp/api/horoscope/

（3）占いデータのフォーマット

占いデータは以下の様な JSON フォーマットで取得できます。

{
  "horoscope":
    {
      "2006/07/01":
	[
	  {
	    "content" : "義理や人情に囚われていると自分の居場所を無くし、苦労に終わりがありません。適度な要領のよさを持つことが必要です。",
	    "item"    : "五百円玉",
	    "money"   : 2,
	    "total"   : 1,
	    "job"     : 1,
	    "color"   : "茶色",
	    "love"    : 1,
	    "rank"    : 12,
	    "sign"    : "牡羊座"
	  },
	  {
	    ... 牡牛座のデータ ...
	  },
	  …
	  …
	  …
	  {
	    ... 水瓶座のデータ
	  }, 

      "2006/07/02";
	  {
	    ... 牡牛座のデータ ...
	  },
	  …
	  …
	  …
	  {
	    ... 水瓶座のデータ
	  }, 
	],    
}

各項目の意味は以下のとおりです。

content

占いの内容

money

金運（5段階評価）

job

仕事運（5段階評価）

love

恋愛運（5段階評価）

total

総合運（5段階評価）

item

ラッキーアイテム

color

ラッキーカラー

rank

ランキング

sign

星座名

（4）各言語用ライブラリ

占いAPIに簡単にアクセスするためのライブラリを、Perl, PHP5, PHP4 用に用意いたしました。ぜひご利用ください。ご利用方法については、各ライブラリに付属のドキュメントをご参照ください。

PHP4

»JugemKey Horoscope API Class

PHP5

»JugemKey Horoscope API Class

Perl

»WebService::JugemKey::Horoscope