# Zapier

Zap, das das Geburtsdatum, die Uhrzeit, die Zeitzone und die Koordinaten aus dem Trigger nimmt, die Karte über die API abfragt und den Aszendenten in den Namen des Zeichens umwandelt. Die untenstehende Anfrage wurde exakt in der Form, wie sie vom Schritt zusammengesetzt wird, an die Produktion gesendet; die Schritte in Zapier sind gemäß der Zapier‑Dokumentation vom 2026-09-17 geschrieben.

<Aside type="caution" title="Kostenpflichtiger Zapier‑Tarif erforderlich">
API by Zapier, Webhooks by Zapier und Formatter sind Premium‑Anwendungen. Die Zapier‑Dokumentation markiert alle drei als im Free‑Tarif nicht verfügbar, und der Schritt Lookup Table erfordert den Professional‑Tarif oder höher. Im Free‑Tarif kannst du [Make](/integrations/make/) oder [n8n](/integrations/n8n/) verwenden.
</Aside>

Erstelle zunächst einen Schlüssel, wie im Abschnitt [Schlüssel für die Automatisierung](/integrations/#ключ-для-автоматизації) beschrieben, mit dem Bereich `chart`.

## 1. Lege den Schlüssel in die Verbindung

Headers, die im Schritt Webhooks by Zapier eingegeben werden, werden im Schritt selbst gespeichert und sind für jeden sichtbar, der Zugriff auf den Zap hat. API by Zapier hält sie in der Verbindung.

1. Klicke auf der Seite **Apps** auf **+ Add connection** und wähle **API by Zapier**.
2. **Authentication type**: Static Headers (API key).
3. **Headers**: `X-Api-Key: ` gefolgt von deinem Schlüssel, in einer Zeile.
4. **Domain filter**: `api.astroway.info`, damit die Verbindung nicht woanders hin geleitet werden kann.

## 2. Rufe die Karte auf

Füge eine Aktion hinzu, wähle **API by Zapier**, das Ereignis **API Request** und die Verbindung.

- **Method**: `POST`.
- **URL**:

  ```
  https://api.astroway.info/v1/chart
  ```

- **Body**: JSON unten mit den Trigger‑Feldern anstelle von Werten.

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

Ersetze jeden Wert durch das entsprechende Trigger‑Feld und lasse die Anführungszeichen um jeden Wert, auch bei Zahlen. Zapier fügt das zugeordnete Feld als reinen Text ein und fügt keine Anführungszeichen hinzu, während die API `"50.45"` als Zahl akzeptiert. Den Schlüssel in den Headers des Schritts füge nicht hinzu: er wird von der Verbindung eingesetzt.

Teste den Schritt. Die korrekte Antwort beginnt mit `"ok": true`, und `data.input.timezoneOffset` ist im Beispiel `4`: die Verschiebung, die Kiew an diesem Tag hatte.

## 3. Wandle den Aszendenten in ein Zeichen um

Zwei Formatter‑Schritte.

**Formatter, Ereignis Numbers, Umwandlung Spreadsheet‑Style Formula.** Formel:

```
FLOOR(ASCENDANT / 30)
```

wobei anstelle von `ASCENDANT` `data.houses.ascendant` aus Schritt 2 eingesetzt wird. Im Beispiel ergibt das `5`.

**Formatter, Ereignis Utilities, Umwandlung Lookup Table.** Der Lookup‑Key ist das Ergebnis der Formel. Tabelle:

| Key | Value |
|---|---|
| 0 | Aries |
| 1 | Taurus |
| 2 | Gemini |
| 3 | Cancer |
| 4 | Leo |
| 5 | Virgo |
| 6 | Libra |
| 7 | Scorpio |
| 8 | Sagittarius |
| 9 | Capricorn |
| 10 | Aquarius |
| 11 | Pisces |

Im Beispiel ist das Ergebnis `Virgo`. Um ukrainische Namen zu erhalten, trage sie in die Spalte Value ein.

Sonne und Mond werden genauso berechnet. Das sind der erste und zweite Eintrag in `data.planets`, jeder mit seiner eigenen `longitude`: im Beispiel 54.34 (Stier) und 296.39 (Steinbock).

## Wenn du Webhooks by Zapier nutzt

Es funktioniert, aber der Schlüssel liegt im Schritt und nicht in der Verbindung. Für die Karte wähle das Ereignis **Custom Request**: es sendet das Feld Data exakt so, wie es eingegeben wurde, sodass das obige JSON unverändert bleibt. Setze **Method** `POST` und füge in **Headers** sowohl `X-Api-Key` mit deinem Schlüssel als auch `Content-Type` mit dem Wert `application/json` hinzu.

## Wenn ein Schritt fehlschlägt

- **`400 INVALID_FIELD` mit `timezone` in `details`**: Die zugeordnete Zone ist leer, es ist eine Abkürzung wie `EST` oder kein Zonenname.
- **`400` mit `date` oder `time` in `details`**: Das Trigger‑Format ist nicht `YYYY-MM-DD` / `HH:MM:SS`; füge vor dem Aufruf einen Formatter‑Schritt für das Datum hinzu.
- **`403 ENDPOINT_NOT_IN_SCOPE`**: Der Schlüssel‑Bereich enthält kein `chart`.
- **`429 KEY_BUDGET_EXHAUSTED`**: Der Schlüssel hat sein Budget aufgebraucht; erhöhe es im Dashboard.

Die API führt keine Geokodierung durch. Wenn der Trigger nur einen Ortsnamen hat, müssen die Koordinaten entweder vom Trigger selbst oder von einem Geokodierungs‑Service kommen, für den du einen Schlüssel hast.