コンテンツと解釈

占星術解釈の包括的なライブラリにアクセスします。

概要

コンテンツAPIは以下の解釈テキストへのアクセスを提供します：

• 惑星のサイン配置
• 惑星のハウス配置
• 惑星間のアスペクト
• トランジット解釈
• シナストリー解釈

コンテンツの一覧

ホロスコープタイプとコンテンツタイプ別にコンテンツを一覧表示する：

curl -X GET "https://api.astroapi.cloud/api/content/natal/planet-in-sign?page[size]=20" \
  -H "X-Api-Key: your-api-key"

コンテンツタイプ

タイプ	説明
planet-in-sign	黄道サインでの惑星配置
planet-in-house	ハウスでの惑星配置
aspect	2つの惑星間のアスペクト
transit	トランジット解釈
synastry	シナストリーアスペクト解釈

ホロスコープタイプ

タイプ	説明
natal	ネイタルチャート解釈
transit	トランジット解釈
synastry	シナストリー解釈
composite	コンポジットチャート解釈
chinese-horoscope	中国占星術解釈
chinese-forecast	中国占星術年間予測解釈
numerology	数秘術解釈
moon-sun	月と太陽の解釈
moon-calendar	月カレンダーの解釈
retrograde	逆行期間の解釈
progression	セカンダリプログレッション解釈
horoscope	一般的なホロスコープ解釈

IDで取得

curl -X GET "https://api.astroapi.cloud/api/content/natal/planet-in-sign/abc123" \
  -H "X-Api-Key: your-api-key"

レスポンス

{
  "data": {
    "type": "content",
    "id": "abc123",
    "attributes": {
      "title": "Sun in Gemini",
      "body": "With your Sun in Gemini, you possess a quick, curious mind...",
      "urn": "urn:content:1:natal:planet-in-sign:sun:gemini:en"
    }
  }
}

Markdown形式

コンテンツレスポンスの body フィールドは Markdown 形式です。これにより、見出し、太字・斜体テキスト、リストなどのリッチテキスト書式設定が可能です。

アプリケーションでコンテンツをHTMLとして表示する場合は、Markdownパーサーライブラリを使用してMarkdownをHTMLに変換する必要があります。

JavaScript/TypeScript

import { marked } from "marked";

const html = marked.parse(content.body);

または markdown-it を使用する場合：

import MarkdownIt from "markdown-it";

const md = new MarkdownIt();
const html = md.render(content.body);

Python

import markdown

html = markdown.markdown(content["body"])

PHP

use League\CommonMark\CommonMarkConverter;

$converter = new CommonMarkConverter();
$html = $converter->convert($content['body']);

タイトルでフィルタリング

filter クエリパラメータを使用してタイトルでコンテンツを検索する：

curl -X GET "https://api.astroapi.cloud/api/content/natal/planet-in-sign?filter=title:*sun*" \
  -H "X-Api-Key: your-api-key"

計算への解釈テキストの組み込み

解釈テキストを取得する推奨方法は、includeText パラメータを使用して計算リクエストに直接含めることです：

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "includeText": true,
    "language": "en"
  }'

これにより、計算レスポンスに各配置とアスペクトの解釈テキストが追加されます。

ページネーション

JSON:APIのページネーションパラメータを使用する：

curl -X GET "https://api.astroapi.cloud/api/content/natal/planet-in-sign?page[size]=10&page[number]=0" \
  -H "X-Api-Key: your-api-key"

レスポンスには、次のページの結果への links.next URLが含まれます。