開発ドキュメント

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

「SNS星座占いAPI」のAPI仕様についてご紹介します。

API概要

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

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

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

提供コンテンツ

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

  • 占い文章
  • 占いランク
  • ラッキーワード/アンラッキーワード
  • ラッキーワードトップ/アンラッキーワードトップ
  • ラッキーワード画像/アンラッキーワード画像

更新タイミング

1回/日(0:05)のタイミングで2日後のデータを先行して作成します。
更新終了までに時間の誤差が生じる可能性がありますので、更新のタイミングの30分後以降のデータの取得を推奨いたします。当日、翌日分は前日までに作成済みです。

リクエスト形式

URI形式

https://[サーバードメイン]/fortune?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 fortuneDate="2020-04-29" lastAnnounce="2020-04-27 00:06:01"> <fortune dateto="04-19" datefrom="03-21" name="牡羊座" code="00"> <rank>04</rank> <text>家族など、身近な存在との間で、価値観の違いを痛感しそうです。</text> <poji_img>https://XXX.XXX.XXX.XXX/uranai/result/20200427_yQfxC/posi_word00.png</poji_img> <poji_top>情報</poji_top> <poji_word>文化,空間,真,無料,顔,有望,気持ち,収入,売上,金,世界,未来,自分</poji_word> <nega_img>https://XXX.XXX.XXX.XXX/uranai/result/20200427_yQfxC/nega_word00.png</nega_img> <nega_top>空腹</nega_top> <nega_word>ズレ,空腹,火,木,コンプレックス</nega_word> </fortune>  :  12星座分繰り返し  : </announce>

JSON形式

{ "announce":{"lastAnnounce":"2020-04-27 00:06:01","fortuneDate":"2020-04-29",   "fortune":[ {"code":"00", "name":"牡羊座", "datefrom":"03-21", "dateto":"04-19", "rank":"04", "text":"家族など、身近な存在との間で、価値観の違いを痛感しそうです。", "poji_img":"https:// XXX.XXX.XXX.XXX /uranai/result/20200427_yQfxC/posi_word00.png", "poji_top":"情報", "poji_word":"文化,空間,真,無料,顔,有望,気持ち,収入,売上,金,世界,未来,自分", "nega_img":"https:// XXX.XXX.XXX.XXX /uranai/result/20200427_yQfxC/nega_word00.png" "nega_top":"空腹", "nega_word":"ズレ,空腹,火,木,コンプレックス" },       :      12星座分繰り返し       : ] } }

各要素の説明

announce

ルート要素です。

lastAnnounce占いデータの生成を行った日時
fortuneDate占いの対象日

fortune

各星座の属性を格納する要素です。

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

rank

各星座でピックアップしたSNS投稿から割り出したラッキー度合いの順位を示す要素です。

rankラッキー度合いの順位
00(ラッキー度高)~11(ラッキー度低)

text

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

text占い結果の文章

poji_img

各星座でピックアップしたSNS投稿から抽出したポジティブワードで生成したラッキーワード画像の保存パスです。

poji_imgラッキーワード画像のURI

poji_top

各星座でピックアップしたSNS投稿から最もポジティブな投稿から得られたワードです。
ポジティブ傾向な投稿がない場合は空白になります。

poji_top最もポジティブな投稿から得られたワード

poji_word

各星座でピックアップしたSNS投稿から得られたポジティブワードです。
ポジティブなワードがない場合は空白になります。

poji_wordポジティブワード

nega_img

各星座でピックアップしたSNS投稿から抽出したネガティブワードで生成したアンラッキーワード画像の保存パスです。

nega_imgアンラッキーワード画像のURI

nega_top

各星座でピックアップしたSNS投稿から最もネガティブな投稿から得られたワードです。
ネガティブ傾向な投稿がない場合は空白になります。

nega_top最もネガティブな投稿から得られたワード

nega_word

各星座でピックアップしたSNS投稿から得られたネガティブワードです。
ネガティブなワードがない場合は空白になります。

nega_wordネガティブワード

レスポンスサンプル

占い文章サンプル

  • 不要になったものは躊躇なくオークションに出すか捨てましょう。
  • スマホの利便性を高めることで、生活の質は上がります。
  • 日頃、依存しているものから離れてみるといい日。
  • 何事にもスムーズに事が運べてスッキリした気分にもひたれるでしょう。
  • やる気はあってもそれらが本当に未来のあなたにとってためになる出来事ばかりではありません。

ラッキーワードサンプル

  • 目標
  • 賃金
  • 人生
  • 友達
  • 主題歌
  • 骨太

アンラッキーワードサンプル

  • 危機
  • コンプレックス
  • 最低
  • 台風
  • 事件
  • 犠牲
  • 悪口

画像サンプル

ネガティブポジティブワード
ネガティブポジティブワード

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