四柱推命API › 夢占いAPI

夢占いAPI

夢の内容を送ると、HRUM が独自に作った夢シンボル語彙から見つかったシンボル語を、目立つ順にJSONで返します。商品名は「夢占い」です。語彙は単語だけを持ち、夢の意味や吉凶の判断は含みません。同じ入力ならいつも同じ結果です。

はじめにガイド プレイグラウンド 料金

返すもの

シンボルが見つからないとき

シンボルが見つからなければ、 items は空の配列で返り、課金されません。

解釈の文章が必要なとき

レスポンスには解釈の文章は含まれません。夢の内容と見つかった語を、 四柱推命解釈API (only: "dream") や LLM API に入力として渡してください。

リクエスト例

{
  "dream": "바다에서 커다란 물고기를 두 손으로 잡는 꿈을 꿨어요"
}

認証は X-Partner-Api-Key ヘッダーで行い、ベースURLは https://api.hrum.ai/api/v1/partners/v1です。Python と JavaScript の例、エラー処理は はじめにガイドにあります。

レスポンス例

{
  "success": true,
  "data": {
    "lang": "ko",
    "mode": "glossary",
    "items": [
      { "keywords": ["바다"], "score": 1 },
      { "keywords": ["물고기"], "score": 0.979 },
      { "keywords": ["손"], "score": 0.749 }
    ]
  }
}

料金

夢占いは1回 ₩30 です（VAT別、VAT込み ₩33）。項目が1つ以上見つかったときだけ課金され、空の結果は差し引かれません。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

一度受け取った結果は保存して再利用してください。 同じリクエストをもう一度送ると、また課金されます。同じ生年月日時と同じオプションならいつも同じ結果なので、最初のレスポンスをデータベースに保存し（例：リクエストボディのハッシュをキーに）、以降は保存した値を無料で使ってください。今日の運勢のように日付で変わる結果は、日付をキーに含め、その日のあいだだけ再利用してください。

料金一覧

リファレンス全体

パラメータ表の全体、レスポンスフィールドの説明、エラーコードはリファレンスにあります: 夢占いAPI リファレンス。ほかの四柱推命商品は 四柱推命APIすべてにあります。

お問い合わせ: contact@float.do · 運営: FLOAT Co., Ltd.