Conteúdo e Interpretações

Acede à biblioteca abrangente de interpretações astrológicas.

Visão Geral

A API de Conteúdo fornece acesso a textos de interpretação para:

• Posicionamento de planetas em signo
• Posicionamento de planetas em casa
• Aspectos entre planetas
• Interpretações de trânsitos
• Interpretações de sinastria

Listar Conteúdo

Lista conteúdo por tipo de horóscopo e tipo de conteúdo:

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

Tipos de Conteúdo

Tipo	Descrição
planet-in-sign	Posicionamento de planeta em signo zodiacal
planet-in-house	Posicionamento de planeta em casa
aspect	Aspecto entre dois planetas
transit	Interpretação de trânsito
synastry	Interpretação de aspecto de sinastria

Tipos de Horóscopo

Tipo	Descrição
natal	Interpretações de mapa natal
transit	Interpretações de trânsitos
synastry	Interpretações de sinastria
composite	Interpretações de mapa composto
chinese-horoscope	Interpretações de horóscopo chinês
chinese-forecast	Interpretações de previsão anual chinesa
numerology	Interpretações de numerologia
moon-sun	Interpretações de Lua e Sol
moon-calendar	Interpretações de calendário lunar
retrograde	Interpretações de períodos de retrogradação
progression	Interpretações de progressão secundária
horoscope	Interpretações de horóscopo geral

Obter por ID

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

Resposta

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

O campo body nas respostas de conteúdo está formatado em Markdown. Isto permite formatação de texto rico, incluindo títulos, negrito/itálico, listas e mais.

Se quiseres exibir o conteúdo como HTML na tua aplicação, terás de converter o Markdown para HTML usando uma biblioteca de análise de markdown.

JavaScript/TypeScript

import { marked } from "marked";

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

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

Filtrar por Título

Pesquisa conteúdo por título usando o parâmetro de consulta filter:

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

Incluir Interpretações com os Cálculos

A forma recomendada de obter textos de interpretação é incluí-los directamente com os teus pedidos de cálculo usando o parâmetro 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"
  }'

Isto enriquece a tua resposta de cálculo com textos de interpretação para cada posicionamento e aspecto.

Paginação

Usa os parâmetros de paginação 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"

A resposta inclui um URL links.next para a próxima página de resultados.