星座占いAPI開発用ドキュメント
「星座占いAPI(ver.1)」のAPI仕様についてご紹介します。
API概要
「星座占いAPI」は占いコンテンツを提供するAPIです。
下記のようなURIにリクエストを送ることで、占いコンテンツがXML/JSONデータとして提供されます。
https://[サーバードメイン]/fortune_astro?userid=[ユーザID]
提供コンテンツ
各星座ごとに、下記のコンテンツを提供します。
- 占い文章
更新タイミング
随時未来日付の占いを先行して準備しています。
取得可能な占い対象年月日は、当日から2か月先までです。
リクエスト形式
URI形式
https://[サーバードメイン]/fortune_astro?userid=[ユーザID]&date=[指定日]&resulttype=[結果形式]
サーバードメイン
urarafortune.net （プライマリAPIサーバードメイン）
urarafortune2.net （セカンダリAPIサーバードメイン）
のいずれかを指定します。
ユーザID
ご契約時に発行されるユーザIDを指定します。
指定日
クエリ変数dateに指定日コードを指定することで、対象日を選択できます。指定形式はyyyymmddです。(例：20200401)
結果形式
クエリ変数resulttypeに結果形式を指定することで、結果の形式を選択できます。(XML形式またはJSON形式)
レスポンス形式
XML形式
<?xml version="1.0" encoding="UTF-8" ?>
<announce lastAnnounce="2020-11-25 13:34:47" astroDate="2020-09-17">
<astro code="0" name="牡羊座" datefrom="03-21" dateto="04-19">
<astrotext>親のように慕っていた人からの思いもよらない言葉や行動に動揺し混乱します。</astrotext>
</astro>
：
12星座分繰り返し
：
</announce>
JSON形式
{
"announce":{"lastAnnounce":"2020-11-25 13:47:54","fortuneDate":"2020-09-17",
"astro":[
{"code":"0",
"name":"牡羊座",
"datefrom":"03-21",
"dateto":"04-19",
"astrotext":"親のように慕っていた人からの思いもよらない言葉や行動に動揺し混乱します。"
},
：
12星座分繰り返し
：
]
}
}
各要素の説明
announce
ルート要素です。
| lastAnnounce | APIの処理日時 |
|---|---|
| fortuneDate | 占いの対象日 |
astro
各星座ごとの占いを格納する要素です。
| code | 00:牡羊座,01:牡牛座,02:双子座,03:蟹座,04:獅子座,05:乙女座,06:天秤座,07:蠍座,08:射手座,09:山羊座,10:水瓶座,11:魚座 |
|---|---|
| name | 星座名称 |
| datefrom | 星座の範囲月日の開始日 |
| dateto | 星座の範囲月日の終了日 |
astrotext
自動生成した占い結果の文章です。
| astrotext | 占い結果の文章 |
|---|
レスポンスサンプル
占い文章サンプル
- 実現できそうな計画があれば貴方も積極的に参加し、全力投球で臨みましょう。
- 友人からの言葉で小さな悩みだと気づき、やがてストレス解消となるでしょう
- ライバルは貴方が思っている以上の事をしてきます。なるべく動向を見守りましょう。
- 友人は貴方の知らないうちに自分のために磨きをかけています。貴方も努力を惜しまずに。
- 必要な事だけしか聞いてこない人との関係性は、長く続かず徐々に薄れるでしょう。
- 心が安らぐ人とのふれあいを持ちましょう。あなた自身の心構えが変わります。
- 意気込みばかりで結果が伴わない相手に対して、不満が爆発しそうです。
- 貴方は初対面の人に明るく良い印象を与え、順調な滑り出しを迎えるでしょう。
- 繊細で消極的な貴方は他人からの忠告に耳を傾けて受け入れるように努力しましょう。
- 真面目で真摯な態度が自然と幸運を呼び込む事となるでしょう。
