開発ドキュメント

星座占いAPI開発用ドキュメント

「星座占いAPI(ver.2)」のAPI仕様についてご紹介します。

API概要

「星座占いAPI」は占いコンテンツを提供するAPIです。

下記のようなURIにリクエストを送ることで、占いコンテンツがXML/JSONデータとして提供されます。

https://[サーバードメイン]/fortune_astro_v2?userid=[ユーザID]

提供コンテンツ

各星座ごとに、下記のコンテンツを提供します。

  • 占い文章S (50〜55文字)
  • 占い文章M (100〜110文字)
  • 占い文章L (200〜220文字)

更新タイミング

随時未来日付の占いを先行して準備しています。
取得可能な占い対象年月日は、当日から2か月先までです。

リクエスト形式

URI形式

https://[サーバードメイン]/fortune_astro_v2?userid=[ユーザID]&date=[指定日]&birth=[生年月日]&resulttype=[結果形式]

サーバードメイン

urarafortune.net 　（プライマリAPIサーバードメイン）
urarafortune2.net （セカンダリAPIサーバードメイン）
のいずれかを指定します。

ユーザID

ご契約時に発行されるユーザIDを指定します。

指定日

クエリ変数dateに指定日コードを指定することで、対象日を選択できます。指定形式はyyyymmddです。(例：20200401)

生年月日

クエリ変数birthに指定日コードを指定することで、対象日を選択できます。指定形式はyyyymmddまたはmmddです。(例：20200401、0401、401)

結果形式

クエリ変数resulttypeに結果形式を指定することで、結果の形式を選択できます。(XML形式またはJSON形式)

レスポンス形式

XML形式

<?xml version="1.0" encoding="UTF-8" ?> <announce lastAnnounce="2024-01-02 13:34:47" astroDate="2024-01-01"> <astro code="0" name="牡羊座" datefrom="03-21" dateto="04-19"> <astrotext_s>新しい趣味や活動を始める勇気を持つことで、素敵な仲間たちとの出会いがあなたの日常を彩ってくれるでしょう。</astrotext> <astrotext_m>新しい趣味や活動を始める勇気を持つことで、素敵な仲間たちとの出会いがあるでしょう。また、新しい挑戦は、自己成長の絶好の機会となります。今はまだ知らない新しい仲間や経験が、あなたの人生を豊かにしてくれることでしょう。</astrotext> <astrotext_l>新しい趣味や活動を始める勇気を持つことで、素敵な仲間たちとの出会いがあなたの日常を彩ってくれるでしょう。新しい挑戦は、未知の領域へのステップとして、自己成長の絶好の機会となります。その過程で出会う人々との繋がりは、時には新しい視点やアイディアをもたらしてくれるかもしれません。共通の興味や目標を共有することは、深い絆や理解を築く上での強力なツールとなります。今はまだ知らない新しい仲間や経験が、あなたの人生を豊かにしてくれることでしょう。</astrotext> </astro> 　： 　12星座分繰り返し 　： </announce>

JSON形式

{ "announce":{"lastAnnounce":"2024-01-02 13:47:54","fortuneDate":"2024-01-01", 　　"astro":[ {"code":"0","name":"牡羊座","datefrom":"03-21","dateto":"04-19", "astrotext_s":"新しい趣味や活動を始める勇気を持つことで、素敵な仲間たちとの出会いがあなたの日常を彩ってくれるでしょう。" "astrotext_m":"新しい趣味や活動を始める勇気を持つことで、素敵な仲間たちとの出会いがあるでしょう。また、新しい挑戦は、自己成長の絶好の機会となります。今はまだ知らない新しい仲間や経験が、あなたの人生を豊かにしてくれることでしょう。" "astrotext_l":"新しい趣味や活動を始める勇気を持つことで、素敵な仲間たちとの出会いがあなたの日常を彩ってくれるでしょう。新しい挑戦は、未知の領域へのステップとして、自己成長の絶好の機会となります。その過程で出会う人々との繋がりは、時には新しい視点やアイディアをもたらしてくれるかもしれません。共通の興味や目標を共有することは、深い絆や理解を築く上での強力なツールとなります。今はまだ知らない新しい仲間や経験が、あなたの人生を豊かにしてくれることでしょう。" }, 　　　　　　： 　　　　　12星座分繰り返し 　　　　　　： ] } }

各要素の説明

announce

ルート要素です。

lastAnnounceAPIの処理日時
astroDate占いの対象日

astro

各星座ごとの占いを格納する要素です。

code00:牡羊座,01:牡牛座,02:双子座,03:蟹座,04:獅子座,05:乙女座,06:天秤座,07:蠍座,08:射手座,09:山羊座,10:水瓶座,11:魚座
name星座名称
datefrom星座の範囲月日の開始日
dateto星座の範囲月日の終了日

astrotext

自動生成した占い結果の文章です。

astrotext_s占い結果の文章(全角50〜55文字)
astrotext_m占い結果の文章(全角100〜110文字)
astrotext_l占い結果の文章(全角200〜220文字)

レスポンスサンプル

占い文章サンプルS (50〜55文字)

初めての場でも、消極的にならずに思い切って交流しましょう。それは、新しい友人や関係を築く一歩となるでしょう。

聞き手としての優しさは貴方の魅力ですが、すべてを受け止める必要はありません。適度に距離を保つことも重要ですよ。

占い文章サンプルM (100〜110文字)

初めての場でも、消極的にならずに思い切って交流しましょう。そうすることで、新しい友人や関係を築く一歩となるでしょう。人々とのコミュニケーションを深めることで、新しい可能性や機会に気づくかもしれません。

聞き手としての優しさは貴方の魅力ですが、すべてを受け止める必要はありません。たまには、自分の気持ちや感情を優先させ、必要に応じて距離を取ることが必要です。心の平安を守ることも、人間関係を維持するための重要なステップです。

占い文章サンプルL (200〜220文字)

初めての場や新しい環境では、不安や緊張を感じるのは自然なことです。しかしその中で、消極的にならずに積極的に交流を試みることは大切です。この一歩が、新しい友情やパートナーシップを築く基盤となります。不安な気持ちを乗り越え、人々とのコミュニケーションを深めることで、自分の視野も広がり、新しい可能性や機会に気づくかもしれません。あえて挑戦することで得られる経験や知識、そして人間関係は、あなたの成長にとって大きな糧となるでしょう。

聞き手としての優しさや理解力は、多くの人から頼られる要因の一つで、あなたの強みでもあります。しかし、常に他人の話を受け止めることは、自分自身の心の負担となることも。人々の悩みや問題を共感しすぎると、自分の感情や気持ちが疲れてしまうことがあります。たまには、自分の気持ちや感情を優先させ、必要に応じて距離を取ることが必要です。関係を大切にする一方で、自分自身のメンタルヘルスや心の平安を守ることも、人間関係を維持するための重要なステップです。

12星座アイコンダウンロード

12星座アイコン
ダウンロード

「星座占いAPI(ver.1)」のAPI仕様はこちらからご覧いただけます。