SNS星座占いAPI開発用ドキュメント
「SNS星座占いAPI」のAPI仕様についてご紹介します。
API概要
「SNS星座占いAPI」は占いコンテンツを提供するAPIです。
下記のようなURIにリクエストを送ることで、占いコンテンツがXML/JSONデータとして提供されます。
https://[サーバードメイン]/fortune?userid=[ユーザID]
提供コンテンツ
各星座ごとに、下記のコンテンツを提供します。
- 占い文章
- 占いランク
- ラッキーワード/アンラッキーワード
- ラッキーワードトップ/アンラッキーワードトップ
- ラッキーワード画像/アンラッキーワード画像
更新タイミング
1回／日（0:05）のタイミングで2日後のデータを先行して作成します。
更新終了までに時間の誤差が生じる可能性がありますので、更新のタイミングの30分後以降のデータの取得を推奨いたします。当日、翌日分は前日までに作成済みです。
リクエスト形式
URI形式
サーバードメイン
urarafortune.net （プライマリAPIサーバードメイン）
urarafortune2.net （セカンダリAPIサーバードメイン）
のいずれかを指定します。
ユーザID
ご契約時に発行されるユーザIDを指定します。
指定日
クエリ変数dateに指定日コードを指定することで、対象日を選択できます。指定形式はyyyymmddです。(例：20200401)
結果形式
クエリ変数resulttypeに結果形式を指定することで、結果の形式を選択できます。(XML形式またはJSON形式)
レスポンス形式
XML形式
JSON形式
各要素の説明
announce
ルート要素です。
| lastAnnounce | 占いデータの生成を行った日時 |
|---|---|
| fortuneDate | 占いの対象日 |
fortune
各星座の属性を格納する要素です。
| code | 00:牡羊座,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 | ネガティブワード |
|---|
レスポンスサンプル
占い文章サンプル
- 不要になったものは躊躇なくオークションに出すか捨てましょう。
- スマホの利便性を高めることで、生活の質は上がります。
- 日頃、依存しているものから離れてみるといい日。
- 何事にもスムーズに事が運べてスッキリした気分にもひたれるでしょう。
- やる気はあってもそれらが本当に未来のあなたにとってためになる出来事ばかりではありません。
ラッキーワードサンプル
- 愛
- 目標
- 賃金
- 人生
- 友達
- 主題歌
- 骨太
アンラッキーワードサンプル
- 危機
- コンプレックス
- 最低
- 台風
- 事件
- 犠牲
- 悪口
画像サンプル
