Code‑freie Integrationen

Dieser Inhalt basiert auf der Produktionsumgebung vom 2026-09-17. Der Workflow für n8n wurde importiert und in einem echten n8n ausgeführt; die Schritte für Zapier und Make wurden gemäß der eigenen Dokumentation dieser Tools erstellt, und die von ihnen erstellten Anfragen wurden genau so gesendet.

Woher die Anfrage stammt

Davon hängt ab, welcher Schlüssel benötigt wird.

• Zapier, Make und n8n senden ihn von ihren Servern. Du benötigst einen “Nur Server”-Schlüssel mit Endpunkt-Bereich und Budget, wie unten beschrieben. Anleitungen: Zapier, Make, n8n.
• Bubble sendet Anfragen ebenfalls von seinen Servern, und der Schlüssel befindet sich im Header, wo er auch bleibt: Bubble.
• FlutterFlow wird zu einer Anwendung kompiliert, die der Benutzer hält, daher muss der Aufruf privat erfolgen: FlutterFlow.
• Wix, Squarespace, Shopify, Webflow und Tilda zeigen die Seite im Browser des Besuchers an. Füge ein Widget ein, keinen Schlüssel: Website-Builder.
• WordPress greift von deinem eigenen Server zu. Der Schlüssel wird vom AstroWay-Plugin verwaltet.

Achtung

Der öffentliche Schlüssel pk_ funktioniert nicht mit Zapier, Make oder n8n. Er lehnt Anfragen ohne Origin aus seiner Liste ab, und diese Tools senden keinen Origin. Von einer Website-Seite funktioniert er nur mit einem Origin aus seiner Liste.

Schlüssel für die Automatisierung

Jeder, der einen Zap, ein Skript oder einen Workflow bearbeiten kann, sieht den Schlüssel darin. Gib daher jeder Automatisierung einen eigenen Schlüssel und beschränke ihn auf das, was sie tut.

1. Öffne im Dashboard die API-Schlüssel und klicke auf Neuer Schlüssel. Benenne ihn nach der Automatisierung, zum Beispiel zapier-intake-form.
2. Lasse im Feld Wo wird dieser Schlüssel verwendet? die Option Nur Server ausgewählt.
3. Kopiere den Schlüssel und speichere ihn: Der Dialog zeigt ihn nur einmal vollständig an. Wenn der Schlüssel verloren geht, klicke im Schlüsselmenü auf Schlüssel aktualisieren: Du erhältst einen neuen, der alte funktioniert nicht mehr.
4. Öffne im Schlüsselmenü Endpunkt-Bereich und liste die Pfade auf, die die Automatisierung aufruft, jeweils einen pro Zeile: chart für das Geburtshoroskop, public/horoscope/* für tägliche Horoskope.
5. Öffne im selben Menü Budget festlegen und gib an, wie viele Kredite dieser Schlüssel pro Zyklus ausgeben darf.

Ein Aufruf außerhalb der Liste erhält 403 ENDPOINT_NOT_IN_SCOPE. Ein Schlüssel, dessen Budget erschöpft ist, erhält 429 KEY_BUDGET_EXHAUSTED, selbst wenn das Konto noch Kredite hat, sodass eine in einer Schleife gefangene Automatisierung bei der angegebenen Zahl stoppt. Beide Beschränkungen gelten für jeden Tarif und sind im Abschnitt Authentifizierung beschrieben.

Sende den Geburtszeitpunkt, nicht den Offset

Das Formular liefert Datum, Uhrzeit und Ort. Sende sie wie folgt:

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": 50.45,
  "longitude": 30.52
}

• timezone ist der Zonenname, und der Server ermittelt selbst den UTC-Offset, den die Uhren an diesem Datum hatten, einschließlich der Sommerzeit. Kiew lebte am 15.05.1990 mit UTC+4, nicht +3: genau diesen Fehler verursacht ein manuell eingegebener Offset. Sende auto, um die Zeitzone aus den Koordinaten zu übernehmen.
• Ohne timezone und ohne Offset wird das Horoskop für UTC berechnet. Die Antwort ist trotzdem 200, überprüfe also, ob das Feld zugeordnet ist.
• Ein leeres timezone wird mit 400 abgelehnt, da sonst ein unausgefülltes Formularfeld als UTC interpretiert würde.
• date im Format YYYY-MM-DD, time im Format HH:MM:SS. Wenn das Formular sie anders speichert, verwende die Datumsformatierung im Tool selbst.
• Zahlen können als Text übermittelt werden. "latitude": "50.45" wird akzeptiert, und genau so senden die meisten Formularfelder sie.
• Die API geocodiert nicht. Die Koordinaten müssen aus dem Formular oder einem Geocodierungsschritt im Tool stammen. Das Feld city ist nur eine Beschriftung.

Die Regeln für die Zeitumstellung und Daten vor 1970 sind in den Feldformaten beschrieben.

Wie Längengrade in Tierkreiszeichen umgewandelt werden

POST /v1/chart antwortet in Grad entlang des Tierkreises, in einem Wrapper { "ok": true, "data": { ... } }. Das Zeichen entspricht floor(longitude / 30), beginnend bei Null:

0 Widder, 1 Stier, 2 Zwillinge, 3 Krebs, 4 Löwe, 5 Jungfrau, 6 Waage, 7 Skorpion, 8 Schütze, 9 Steinbock, 10 Wassermann, 11 Fische.

Wo die drei beliebtesten Werte liegen:

• Sonne: Eintrag in data.planets mit "name": "Sun", der erste.
• Mond: Eintrag in data.planets mit "name": "Moon", der zweite.
• Aszendent: data.houses.ascendant.
• Verwendeter Offset: data.input.timezoneOffset.

Für das obige Beispiel: Sonne 54.34, also Stier; Mond 296.39, Steinbock; Aszendent 159.26, Jungfrau; Offset 4.

Was kostet das

• POST /v1/chart kostet 20 Kredite. Eine vollständige Tabelle findest du auf der Seite Endpunkt-Kosten.
• Dieselbe Anfrage, die innerhalb von fünf Minuten erneut gesendet wird, wird aus dem Cache zurückgegeben und nicht abgerechnet. Ein Testlauf, der denselben Body wiederholt, verbraucht kein Budget.
• GET /v1/public/horoscope/daily verbraucht keine Kredite. Ohne Schlüssel oder mit einem Schlüssel im Free-Tarif wird er auf das Limit von 30 Anfragen pro Stunde von einer IP-Adresse angerechnet, und Automatisierungsplattformen teilen ihre Adressen unter den Clients auf. Ein Schlüssel im kostenpflichtigen Tarif hat ein eigenes Limit.