Reports API - 16 fertige PDF-Berichte unter deiner Marke
Du sendest ein Geburtsdatum, du erhältst ein fertiges Dokument. Nicht JSON, aus dem du ein PDF rendern musst, sondern das PDF selbst: seitenweise formatiert, mit deinem Logo, deinem Berichtsnamen und ohne jegliche Erwähnung von uns darin.
Sechzehn solcher Berichte sind bereits in Betrieb. Zusammen mit dem Dispatcher, der Export-Historie und fünf KI-Narrativen sind das 23 Pfade unter /v1/reports/*.
Katalog
Abschnitt betitelt „Katalog“Jede Zeile enthält ein fertiges Beispiel. Dies ist kein Mockup: Die Datei wurde mit demselben Aufruf generiert, der in der Referenz dieses Endpoints aufgeführt ist, und wird zusammen mit den Vorlagen neu veröffentlicht.
Die Seitenzahl ist die, die dieses Beispiel geliefert hat, gemessen am 21.09.2026. Sie variiert je nach Karte: Mehr Aspekte bedeuten mehr Zeilen, und relocation fügt zwei bis drei Seiten pro Stadt hinzu (4 Seiten für eine Stadt, 13 für fünf).
| Endpoint | Inhalt | Seiten | Credits | Beispiel |
|---|---|---|---|---|
/v1/reports/natal | Große Drei, Planeten, Häuser, Aspekte | 3 | 5 000 | |
/v1/reports/synastry | Interkarten-Aspekte zweier Karten, Elementebalance | 2 | 5 000 | |
/v1/reports/transit-yearly | Transitprognose für das ausgewählte Jahr | 5 | 5 000 | |
/v1/reports/relocation | Ursprungskarte, bis zu 5 Städte, Planeten, die das Haus gewechselt haben, Linien in der Nähe, 19 Lebensbereiche | 6 | 5 000 | |
/v1/reports/vedic-kundli | Lagna und Nakshatra, siderische Positionen, Vimshottari Mahadashas | 2 | 5 000 | |
/v1/reports/lal-kitab | Kismat, Teva, identifizierte Rinas, Upayas | 2 | 5 000 | |
/v1/reports/gemstone | Edelsteinempfehlung mit Mantras, Edelsteine, die nicht getragen werden sollten, Zustand der Grahas | 7 | 5 000 | |
/v1/reports/human-design | Schlüsselparameter, Zentren, Kanäle | 2 | 5 000 | |
/v1/reports/muhurta | Rangierte günstige Tage für eine Aktivität | 4 | 5 000 | |
/v1/reports/love | Schlüsselpunkte der Liebe, Große Drei, Aspekte | 2 | 5 000 | |
/v1/reports/career | Schlüsselpunkte der Karriere, Persönlichkeitskontext, Aspekte | 2 | 5 000 | |
/v1/reports/money | Schlüsselpunkte der Finanzen, Häuser, Aspekte | 3 | 5 000 | |
/v1/reports/business | Schlüsselpunkte des Geschäfts, Häuser, Aspekte | 2 | 5 000 | |
/v1/reports/child | Schlüsselcharakterzüge, Große Drei, Planeten | 2 | 5 000 | |
/v1/reports/stellaforge | Einseitiges Kartenposter: Planeten, Balance, Schlüssel-Aspekte | 1 | 5 000 | |
/v1/reports/tarot | Beschreibung des Legemusters und der Karten | 2 | 100 | |
/v1/reports/vastu | Hausplan mit Mandala, Bewertung, Vastu-Erkenntnisse mit Quellen und Korrekturen | 2 | 5 000 |
Tarot kostet fünfzigmal weniger, da es keine Ephemeriden gibt: eine Seite des Legemusters ohne astronomische Berechnungen.
Tiefe: standard oder extended
Abschnitt betitelt „Tiefe: standard oder extended“/v1/reports/natal (und /v1/reports/generate mit report_type: "natal") akzeptiert depth. standard ist das obige Dokument, 5000 Credits. extended kostet 10000 Credits und fügt ein Kartenrad und einen Abschnitt für jeden Körper von der Sonne bis Pluto, Chiron und den Aszendenten im Zeichen hinzu: zwölf Abschnitte, jeder zwei bis vier Seiten bearbeiteten Textes (Beispiel-PDF, 13 Seiten) aus demselben Korpus, den /v1/natal-texts zurückgibt. Nichts wird auf Anfrage generiert, daher liefert dieselbe Karte dasselbe Dokument.
Die Abschnitte sind in 20 Sprachen verfügbar, den Sprachen der Website; depth: "extended" mit einer anderen Sprache wird mit 400 abgelehnt und nicht aus einer anderen Sprache befüllt. Andere Berichtstypen haben derzeit nur eine Tiefe: Ihre langen Abschnitte sind noch nicht geschrieben.
Ein Pfad statt sechzehn
Abschnitt betitelt „Ein Pfad statt sechzehn“POST /v1/reports/generate akzeptiert das Feld report_type und tut dasselbe wie ein separater Pfad. Zwölf Typen: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.
Für das SDK ist dies eine Methode statt zwölf, für MCP ein Tool statt zwölf. Der Preis ist derselbe: Ein Aufruf über den Dispatcher berechnet genau so viel wie ein direkter Pfad.
PDF oder HTML
Abschnitt betitelt „PDF oder HTML“Standardmäßig erhältst du ein PDF und einen Link dazu. ?format=html liefert eine fertige HTML-Seite direkt in der Antwort, ohne Rendering und ohne Speicherung: praktisch, wenn du den Bericht in deine Seite einbettest oder dein eigenes CSS verwenden möchtest.
Der PDF-Link ist 24 Stunden gültig. Um dem Kunden einen länger gültigen Link zu geben, füge ?retain_days=30 (bis zu 90) hinzu: Die Datei bleibt dann so viele Tage gespeichert, und expires_at in der Antwort zeigt dies an. Wir hosten keine fremden Dokumente auf unbestimmte Zeit, und du kannst eine Datei früher über DELETE /v1/reports/files/{filename} kostenlos löschen. Die Datei enthält das, was du gesendet hast, zusammen mit dem Namen, daher ist die Speicherdauer im DPA, Abschnitt 2, beschrieben. GET /v1/reports/history zeigt kostenlos die letzten Exporte dieses Schlüssels an, und ein abgelaufener Eintrag kommt mit expired: true.
Deine Marke, nicht unsere
Abschnitt betitelt „Deine Marke, nicht unsere“whitelabel akzeptiert ein Objekt mit 15 Feldern: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing und fünf Farben (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).
Du kannst es direkt in der Anfrage übergeben, und dann sind keine Kontoeinstellungen erforderlich:
curl -X POST https://api.astroway.info/v1/reports/natal \ -H "X-Api-Key: aw_live_..." \ -H "Content-Type: application/json" \ -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }, "whitelabel": { "companyName": "Zoryana Studio", "reportName": "Your Birth Blueprint", "themeColor": "#7c3aed", "footerText": "zoryana.example" } }'Im generierten Dokument sind der Name des Studios, dein eigener Berichtstitel, die Akzentfarbe in den Abschnittsüberschriften und deine Fußzeile enthalten. Das Wort AstroWay kommt darin kein einziges Mal vor.
Eine Alternative für diejenigen, die das Objekt nicht in jeder Anfrage wiederholen möchten: whitelabel: true verwendet die gespeicherte Kontokonfiguration. Lege sie auf der Seite Berichts-Branding im Konto fest: Firmenname, Berichtsname, Kontakte, Logo und zwei Farben, mit einer Vorschau des Beispiel-Natalberichts. Dieselben Einstellungen sind mit dem Schlüssel über /v1/whitelabel/config und /v1/whitelabel/logo verfügbar, und POST /v1/whitelabel/preview zeichnet ein Beispiel als PDF. Ein im Objekt übergebenes Feld hat Vorrang vor dem gespeicherten.
Fertige Anwendung zum Klonen
Abschnitt betitelt „Fertige Anwendung zum Klonen“Live-Demo und Code auf GitHub, MIT.
Der Schreibtisch des Praktikers: Kundendaten links, fertiges PDF rechts. Jede Berichtskachel zeigt den Preis in Credits vor dem Klick und führt zu einem fertigen Beispiel. White-Label wird mit einem Häkchen aktiviert. Das Backend ist eine Route ohne Abhängigkeiten, denn das ist der Kern: Der Browser kann die API nicht direkt aufrufen, daher lebt der Schlüssel auf dem Server.
git clone https://github.com/astroway/starter-practicecd starter-practice && npm installcp .env.example .env # your key goes herenpm run devVier Dinge, die es wert sind, mitgenommen zu werden. Der Preis wird dort angezeigt, wo die Entscheidung getroffen wird: Der Server gibt X-Credits-Used zurück an die Seite, nicht nur in den Log. Sechzehn Berichte haben vier Anfrageformulare, nicht sechzehn. Dieselbe Anfrage kostet beim zweiten Mal null, da der Antwort-Cache dieselbe Datei zurückgibt. Und ALLOWED_REPORTS begrenzt, was die Instanz rendern wird: Die öffentliche Demo rendert nur das Tarot-Legemuster (/v1/reports/tarot, 100 Credits), da eine Seite im offenen Internet, die einen Natalbericht (/v1/reports/natal, 5 000) für jedermann erstellt, das monatliche kostenlose Limit mit zwei Klicks aufbraucht.
Sprachen
Abschnitt betitelt „Sprachen“Das Feld language akzeptiert 21 Codes. Vollständig übersetzt sind drei: Ukrainisch, Englisch, Russisch. Für die restlichen achtzehn werden die Namen der Zeichen lokalisiert, während Überschriften und Erklärungen englisch bleiben: Ein deutscher Bericht schreibt “Löwe” unter der Überschrift “Planets”.
Wir schreiben dies direkt, denn der Bericht ist ein Dokument, das dein Kunde behält. Ihn als deutsch zu verkaufen, nachdem man im Beispiel deutsche Zeichennamen gesehen hat, wäre eine unangenehme Überraschung auf Kundenseite, nicht auf unserer. Der muhurta-Bericht ist bisher vollständig englisch.
Wie viele Berichte sind im Plan enthalten
Abschnitt betitelt „Wie viele Berichte sind im Plan enthalten“/v1/reports/natal und die restlichen PDFs kosten 5 000 Credits, daher lässt sich das monatliche Planlimit einfach in die Anzahl der Berichte umrechnen:
| Plan | Credits/Monat | PDF-Berichte | Tarot-Berichte |
|---|---|---|---|
| Free | 10 000 | Berichte nicht verfügbar | nicht verfügbar |
| Indie, $5 | 50 000 | 10 | 500 |
| Starter, $19 | 200 000 | 40 | 2 000 |
| Pro, $59 | 800 000 | 160 | 8 000 |
| Business, $199 | 3 500 000 | 700 | 35 000 |
| Reports Pack, $99 | 1 500 000 | 300 | 15 000 |
Im Free-Plan sind Berichte absichtlich gesperrt: Ein PDF bedeutet Sekunden Arbeit für Chrome auf unserer Seite, und der kostenlose Tarif deckt dies nicht ab. Der günstigste Einstieg ist Indie für $5.
Reports Pack ist ein separates Add-on für diejenigen, die nur Berichte benötigen: $99 pro Monat, 1 500 000 Credits, also 300 PDFs zu 33 Cent pro Stück, mit White-Label. Das ist günstiger pro PDF als im Pro-Plan, da der Schlüssel nirgendwo anders als zu Berichten geht. Ein Schlüssel dieses Plans funktioniert nur für /v1/reports/* und /v1/whitelabel/*.
Weiterverkauf von Berichten: Was kostet dich ein PDF
Abschnitt betitelt „Weiterverkauf von Berichten: Was kostet dich ein PDF“Wenn du Berichte an deine Kunden verkaufst, zählt eine Zahl: Was kostet dich ein PDF bei deinem Volumen. Innerhalb des Planlimits ist dies der Planpreis geteilt durch die Anzahl der PDFs. Über dem Limit wird jedes PDF als Overusage berechnet, die für alle 10 000 Credits über dem Limit anfällt, sodass ein PDF für 5000 Credits die Hälfte des Overusage-Satzes des Plans kostet.
| Plan | PDFs im Plan | Preis pro PDF innerhalb | Jedes PDF darüber |
|---|---|---|---|
| Indie, $5 | 10 | $0.50 | $2.50 |
| Starter, $19 | 40 | $0.48 | $2.50 |
| Pro, $59 | 160 | $0.37 | $1.50 |
| Reports Pack, $99 | 300 | $0.33 | $1.50 |
| Business, $199 | 700 | $0.28 | $1.00 |
Der günstigste Plan hängt also davon ab, wie viele PDFs du pro Monat verkaufst, inklusive Overusage:
| PDFs pro Monat | Günstigster Plan | Deine Kosten | Pro PDF |
|---|---|---|---|
| 10 | Indie | $5 | $0.50 |
| 40 | Starter | $19 | $0.48 |
| 100 | Pro | $59 | $0.59 |
| 160 | Pro | $59 | $0.37 |
| 300 | Reports Pack | $99 | $0.33 |
| 500 | Business | $199 | $0.40 |
| 700 | Business | $199 | $0.28 |
Umschaltpunkte: Starter ist ab 16 PDFs günstiger als Indie, Pro ab 57 als Starter, Reports Pack ab 187 als Pro, wenn du nichts außer Berichten benötigst, Business ab 367 als Reports Pack. Pro und Business öffnen auch den Rest der API, Pack nur Berichte und White-Label.
Die Marge legst du fest. Bei 300 PDFs im Reports Pack betragen deine Kosten $99 pro Monat. Für $9 pro Stück sind das $2700 Einnahmen gegenüber $99 Kosten, für $19 sind es $5700. Wir empfehlen keinen Einzelhandelspreis, aber die Arithmetik ist immer dieselbe: dein Preis minus 33 Cent.
Ein erweiterter Natalbericht kostet doppelt so viel wie ein Standardbericht, daher ist dies bei jedem höheren Plan der doppelte Preis pro PDF: $0.66 im Reports Pack.
Zwei Dinge senken die tatsächlichen Kosten zusätzlich. Eine wiederholte Anfrage mit denselben Daten gibt dieselbe Datei aus dem Antwort-Cache zurück und kostet nichts, sodass ein Kunde, der den Bericht zweimal heruntergeladen hat, nur einmal bezahlt wird. Und ein Jahresplan sind 12 Monate zum Preis von 9, und das Reports Pack kostet dann $0.25 pro PDF.
Bevor du verkaufst, öffne die Beispiele: Jedes ist genau die Datei, die die API zurückgibt, und mit whitelabel treten dein Name und deine Farben an die Stelle der Standardwerte.
Wenn du Text statt eines Dokuments benötigst
Abschnitt betitelt „Wenn du Text statt eines Dokuments benötigst“Fünf Endpoints geben ein KI-Narrativ als JSON zurück, ohne Layout und ohne PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Jeweils 250 Credits. Verwende sie, wenn der Text in dein eigenes Layout, deine Anwendung oder deinen Newsletter integriert werden soll.
Der Natalbericht unterstützt auch einen gemischten Modus: enrich: true fügt das KI-Narrativ in das PDF ein. Bei derselben Testkarte sind das 5 Seiten statt 3.