Контент и интерпретации

Получайте доступ к обширной библиотеке астрологических интерпретаций.

Обзор

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	Аспект между двумя планетами
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 в HTML с помощью библиотеки-парсера markdown.

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"

Ответ включает URL links.next для следующей страницы результатов.