Contenuti & Interpretazioni

Accedi alla libreria completa di interpretazioni astrologiche.

Panoramica

L'API dei Contenuti fornisce accesso ai testi di interpretazione per:

• Posizionamenti dei pianeti nei segni
• Posizionamenti dei pianeti nelle case
• Aspetti tra pianeti
• Interpretazioni dei transiti
• Interpretazioni della sinastria

Elenco dei Contenuti

Elenca i contenuti per tipo di oroscopo e tipo di contenuto:

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

Tipi di Contenuto

Tipo	Descrizione
planet-in-sign	Posizionamento del pianeta nel segno zodiacale
planet-in-house	Posizionamento del pianeta nella casa
aspect	Aspetto tra due pianeti
transit	Interpretazione del transito
synastry	Interpretazione dell'aspetto di sinastria

Tipi di Oroscopo

Tipo	Descrizione
natal	Interpretazioni del tema natale
transit	Interpretazioni dei transiti
synastry	Interpretazioni della sinastria
composite	Interpretazioni del tema composito
chinese-horoscope	Interpretazioni dell'oroscopo cinese
chinese-forecast	Interpretazioni delle previsioni annuali cinesi
numerology	Interpretazioni numerologiche
moon-sun	Interpretazioni di Luna e Sole
moon-calendar	Interpretazioni del calendario lunare
retrograde	Interpretazioni dei periodi retrogradazione
progression	Interpretazioni delle progressioni secondarie
horoscope	Interpretazioni generali dell'oroscopo

Recupero per ID

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

Risposta

{
  "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"
    }
  }
}

Formato Markdown

Il campo body nelle risposte dei contenuti è formattato in Markdown. Questo consente una formattazione ricca del testo, inclusi titoli, testo in grassetto/corsivo, elenchi e altro.

Se vuoi visualizzare il contenuto come HTML nella tua applicazione, dovrai convertire il Markdown in HTML utilizzando una libreria parser Markdown.

JavaScript/TypeScript

import { marked } from "marked";

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

Oppure con 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']);

Filtraggio per Titolo

Cerca contenuti per titolo usando il parametro di query filter:

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

Inclusione delle Interpretazioni con i Calcoli

Il metodo consigliato per ottenere i testi interpretativi è includerli direttamente nelle richieste di calcolo usando il parametro 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"
  }'

Questo arricchisce la risposta del calcolo con testi interpretativi per ogni posizionamento e aspetto.

Paginazione

Utilizza i parametri di paginazione 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"

La risposta include un URL links.next per la pagina successiva dei risultati.