Contenu & Interprétations

Accédez à la bibliothèque complète d'interprétations astrologiques.

Vue d'Ensemble

L'API de Contenu donne accès aux textes d'interprétation pour :

• Les placements de planètes dans les signes
• Les placements de planètes dans les maisons
• Les aspects entre planètes
• Les interprétations de transits
• Les interprétations de synastrie

Lister le Contenu

Listez le contenu par type d'horoscope et type de contenu :

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

Types de Contenu

Type	Description
planet-in-sign	Placement d'une planète dans un signe zodiacal
planet-in-house	Placement d'une planète dans une maison
aspect	Aspect entre deux planètes
transit	Interprétation de transit
synastry	Interprétation d'aspect de synastrie

Types d'Horoscope

Type	Description
natal	Interprétations de thèmes natals
transit	Interprétations de transits
synastry	Interprétations de synastrie
composite	Interprétations de thèmes composites
chinese-horoscope	Interprétations d'horoscopes chinois
chinese-forecast	Interprétations de prévisions annuelles chinoises
numerology	Interprétations de numérologie
moon-sun	Interprétations de la lune et du soleil
moon-calendar	Interprétations du calendrier lunaire
retrograde	Interprétations des périodes de rétrograde
progression	Interprétations de progressions secondaires
horoscope	Interprétations générales d'horoscopes

Récupérer par ID

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

Réponse

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

Format Markdown

Le champ body dans les réponses de contenu est formaté en Markdown. Cela permet une mise en forme de texte riche incluant des titres, du texte en gras/italique, des listes, et plus encore.

Si vous souhaitez afficher le contenu en HTML dans votre application, vous devrez convertir le Markdown en HTML à l'aide d'une bibliothèque d'analyse Markdown.

JavaScript/TypeScript

import { marked } from "marked";

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

Ou avec 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']);

Filtrer par Titre

Recherchez du contenu par titre en utilisant le paramètre de requête filter :

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

Inclure des Interprétations avec les Calculs

La méthode recommandée pour obtenir des textes d'interprétation est de les inclure directement avec vos requêtes de calcul en utilisant le paramètre 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"
  }'

Cela enrichit votre réponse de calcul avec des textes d'interprétation pour chaque placement et aspect.

Pagination

Utilisez les paramètres de pagination 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 réponse inclut une URL links.next pour la page suivante de résultats.