PDF-Berichte

Erstellen Sie professionelle PDF-Berichte für Geburtshoroskope, Synastrien, Sonnenrückkehren und mehr. Das PDF-Berichte-Modul ermöglicht Ihnen die Erstellung anpassbarer Astrologieberichte mit Interpretationen, Horoskopen und Tabellen.

Übersicht

Die PDF-Berichte-Funktion bietet:

• Mehrere Berichtstypen: Natal, Synastrie, Komposit, Transit, Sonnenrückkehr, Mondrückkehr, Progressionen, Numerologie und chinesische Astrologie
• Anpassbare Vorlagen: Erstellen und verwalten Sie eigene PDF-Vorlagen mit benutzerdefinierten Layouts
• Automatische Berechnungen: Astrologiedaten werden on-the-fly berechnet und in Ihre Vorlage eingebettet
• Professionelle Ausgabe: Hochwertige PDF-Erstellung mit Unterstützung für Kopf-/Fußzeilen, Seitenzahlen und benutzerdefiniertes CSS

Unterstützte Berichtstypen

Berichtstyp	Beschreibung
natal	Geburtshoroskop-Analyse mit Planetenpositionen, Häusern und Aspekten
synastry	Beziehungskompatibilität zwischen zwei Horoskopen
composite	Kombiniertes Horoskop für Beziehungen
transit	Aktuelle planetare Transite zum Geburtshoroskop
solar-return	Jährliches Geburtstaghoroskop
lunar-return	Monatliches Mondrückkehr-Horoskop
progressions	Sekundäre Progressionen
numerology	Numerologie-Berechnungen und -Analyse
chinese	Chinesischer Astrologiebericht

Einen PDF-Bericht erstellen

Erstellen Sie einen PDF-Bericht, indem Sie Geburtsdaten angeben und optional eine Vorlage festlegen.

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/generate" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "natal",
    "subject": {
      "name": "John Doe",
      "birthDate": {
        "year": 1990,
        "month": 6,
        "day": 15,
        "hour": 14,
        "minute": 30
      },
      "birthPlace": {
        "name": "London, UK",
        "latitude": 51.5074,
        "longitude": -0.1278,
        "timezone": "Europe/London"
      }
    }
  }' \
  --output natal-report.pdf

Anfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
reportType	string	Ja	Berichtstyp (siehe unterstützte Typen oben)
templateId	string	Nein	Bestimmte Vorlagen-ID (verwendet Standard, wenn nicht angegeben)
subject	object	Ja	Geburtsdaten für die Hauptperson
partner	object	Nein	Geburtsdaten für Partner (erforderlich für Synastrie/Komposit)
transitDate	object	Nein	Zieldatum für Transit-/Rückkehrberichte

Subjekt-Objekt

Feld	Typ	Erforderlich	Beschreibung
name	string	Ja	Name der Person
birthDate	object	Ja	Geburtsdatum und -uhrzeit
birthDate.year	number	Ja	Geburtsjahr
birthDate.month	number	Ja	Geburtsmonat (1–12)
birthDate.day	number	Ja	Geburtstag (1–31)
birthDate.hour	number	Ja	Geburtsstunde (0–23)
birthDate.minute	number	Ja	Geburtsminute (0–59)
birthPlace	object	Ja	Geburtsort
birthPlace.name	string	Ja	Ortsname
birthPlace.latitude	number	Ja	Breitengrad (-90 bis 90)
birthPlace.longitude	number	Ja	Längengrad (-180 bis 180)
birthPlace.timezone	string	Ja	IANA-Zeitzonenkennung

Antwort

Der Endpunkt gibt eine PDF-Datei (application/pdf) mit dem generierten Bericht zurück.

Synastrie-Berichtsbeispiel

Einen Synastrie-Bericht erstellen, der zwei Geburtshoroskope vergleicht:

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/generate" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "synastry",
    "subject": {
      "name": "Person A",
      "birthDate": {
        "year": 1990,
        "month": 6,
        "day": 15,
        "hour": 14,
        "minute": 30
      },
      "birthPlace": {
        "name": "London, UK",
        "latitude": 51.5074,
        "longitude": -0.1278,
        "timezone": "Europe/London"
      }
    },
    "partner": {
      "name": "Person B",
      "birthDate": {
        "year": 1988,
        "month": 3,
        "day": 22,
        "hour": 9,
        "minute": 15
      },
      "birthPlace": {
        "name": "Paris, France",
        "latitude": 48.8566,
        "longitude": 2.3522,
        "timezone": "Europe/Paris"
      }
    }
  }' \
  --output synastry-report.pdf

Sonnenrückkehr-Berichtsbeispiel

Einen Sonnenrückkehr-Bericht für ein bestimmtes Jahr erstellen:

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/generate" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "solar-return",
    "subject": {
      "name": "John Doe",
      "birthDate": {
        "year": 1990,
        "month": 6,
        "day": 15,
        "hour": 14,
        "minute": 30
      },
      "birthPlace": {
        "name": "London, UK",
        "latitude": 51.5074,
        "longitude": -0.1278,
        "timezone": "Europe/London"
      }
    },
    "transitDate": {
      "year": 2025,
      "month": 6,
      "day": 15,
      "hour": 0,
      "minute": 0
    }
  }' \
  --output solar-return-2025.pdf

Vorlagenverwaltung

Vorlagen definieren das Layout und den Inhalt Ihrer PDF-Berichte. Jede Vorlage ist einem bestimmten Berichtstyp zugeordnet.

Vorlagen auflisten

curl -X GET "https://api.astroapi.cloud/api/pdf-reports/templates" \
  -H "X-Api-Key: your-api-key"

Gibt sowohl organisationsspezifische als auch globale (gemeinsame) Vorlagen zurück.

Eine bestimmte Vorlage abrufen

curl -X GET "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}" \
  -H "X-Api-Key: your-api-key"

Eine Vorlage erstellen

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/templates" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "templates",
      "attributes": {
        "name": "My Natal Report Template",
        "description": "Custom natal chart report",
        "reportType": "natal",
        "editorConfig": {},
        "pageSettings": {
          "format": "A4",
          "orientation": "portrait",
          "margins": {
            "top": 20,
            "right": 20,
            "bottom": 20,
            "left": 20
          }
        },
        "isDefault": true
      }
    }
  }'

Vorlagenattribute

Attribut	Typ	Beschreibung
name	string	Vorlagenname (1–100 Zeichen)
description	string	Optionale Beschreibung
reportType	string	Berichtstyp, für den diese Vorlage gilt
editorConfig	object	Editor.js-Block-Konfiguration
pageSettings	object	Seitenlayout-Einstellungen
customCss	string	Benutzerdefinierte CSS-Stile
isDefault	boolean	Als Standard für diesen Berichtstyp festlegen
isActive	boolean	Ob die Vorlage aktiv ist

Seiteneinstellungen

Einstellung	Typ	Beschreibung
format	string	Seitengröße: "A4" oder "Letter"
orientation	string	"portrait" oder "landscape"
margins	object	Seitenränder in mm (oben, rechts, unten, links)
header	object	Kopfzeilen-Konfiguration
footer	object	Fußzeilen-Konfiguration
pageNumbers	object	Seitenzahleneinstellungen

Kopf-/Fußzeilen-Konfiguration

{
  "header": {
    "enabled": true,
    "height": 15,
    "content": "My Astrology Report"
  },
  "footer": {
    "enabled": true,
    "height": 15,
    "content": "Generated by AstroAPI"
  },
  "pageNumbers": {
    "enabled": true,
    "position": "bottom-center",
    "format": "Page <span class=\"pageNumber\"></span> of <span class=\"totalPages\"></span>"
  }
}

Eine Vorlage aktualisieren

curl -X PATCH "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "templates",
      "attributes": {
        "name": "Updated Template Name"
      }
    }
  }'

Eine Vorlage löschen

curl -X DELETE "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}" \
  -H "X-Api-Key: your-api-key"

Eine Vorlage duplizieren

Eine bestehende Vorlage (einschließlich globaler Vorlagen) in Ihre Organisation kopieren:

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}/duplicate" \
  -H "X-Api-Key: your-api-key"

Standardvorlage festlegen

Eine Vorlage als Standard für ihren Berichtstyp festlegen:

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}/set-default" \
  -H "X-Api-Key: your-api-key"

Vorlage in der Vorschau anzeigen

Anzeigen, wie eine Vorlage mit Beispieldaten gerendert wird (gibt HTML zurück):

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/preview" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "your-template-id"
  }'

Vorlagenauflösung

Bei der Erstellung eines PDFs wird die zu verwendende Vorlage in dieser Reihenfolge bestimmt:

1. Bestimmte Vorlage: Wenn templateId in der Anfrage angegeben ist
2. Organisationsstandard: Die Standard-Vorlage der Organisation für den Berichtstyp
3. Globaler Standard: Eine globale (gemeinsame) Standardvorlage für den Berichtstyp

Erforderliche Berechtigungen

Endpunkt	Berechtigung
Vorlagen auflisten/abrufen	content:read
PDF erstellen	content:read
Vorlage in Vorschau anzeigen	content:read
Vorlage erstellen	content:create
Vorlage aktualisieren	content:update
Vorlage löschen	content:delete
Vorlage duplizieren	content:create
Standard festlegen	content:update

Berichtsinhalt

Generierte Berichte enthalten:

• Subjektinformationen: Name, Geburtsdatum, -uhrzeit und -ort
• Planetenpositionen: Alle Hauptplaneten mit Zeichen, Haus und Grad
• Hauskuppen: Alle 12 Hauskuppen mit Zeichen
• Aspekte: Planetenaspekte mit Orbs und Interpretationen
• Interpretationen: CMS-Textinhalte für jede Stellung und jeden Aspekt

Der tatsächliche Inhalt hängt von der Vorlagenkonfiguration und den verfügbaren CMS-Inhalten ab.