# n8n

Workflow négy csomóponttal: a bemeneten a születési adatok, középen a születési horoszkópa az API-val, a kimeneten a Nap, Hold és Ascendens jelek. Importálva n8n 2.39.7-be és futtatva a production környezet ellen 2026-09-17, az alábbi eredményt adta vissza.

Először hozzon létre egy kulcsot, ahogy a [Automatizálási kulcs](/integrations/#automatizálási-kulcs) szakaszban leírják, a `chart` hatókörrel.

## 1. Adja hozzá a kulcsot hitelesítő adatként

A kulcs az n8n hitelesítő adatok tárolójában van tárolva, nem a csomópontban, ezért nem kerül az exportált workflow-be.

1. Hozzon létre egy új hitelesítő adatot n8n-ben **Header Auth** típusként.
2. **Name**: `X-Api-Key`.
3. **Value**: a kulcsa.
4. Mentsd el **AstroWay API key** néven. Az alábbi workflow pont ezen a néven keresi a hitelesítő adatot.

## 2. Importálja a workflow-t

Töltse be a [n8n-natal-chart.json](/integrations/n8n-natal-chart.json) fájlt, nyisson egy üres workflow-t, és illessze be a fájl tartalmát a vászonra, vagy használja a fájlból való importálást a menüben.

Belsőleg négy csomópont:

- **Start**, Manual Trigger csomópont: elindítja a workflow-t teszteléskor.
- **Birth data**, Edit Fields (Set) csomópont: egy személy `date`, `time`, `timezone`, `latitude` és `longitude` adatai.
- **AstroWay chart**, HTTP Request csomópont: meghívja a `POST /v1/chart` végpontot.
- **Big three**, Edit Fields (Set) csomópont: a hosszúságot jelek nevévé alakítja.

## 3. Futtassa

Futtassa a workflow-t. A **Big three** visszaadja:

```json
{
  "sun": "Taurus",
  "moon": "Capricorn",
  "rising": "Virgo",
  "offset_used": 4
}
```

`offset_used` az UTC eltolás, amit a szerver talált a `Europe/Kyiv` időzónára 1990-05-15: 4, nem 3, amit általában kézzel írnak.

## Hogyan van beállítva az HTTP Request csomópont

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

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

- **Authentication**: Generic Credential Type.
- **Generic Auth Type**: Header Auth, hitelesítő adat **AstroWay API key**.
- **Send Body**: bekapcsolva.
- **Body Content Type**: JSON.
- **Specify Body**: Using JSON.

A test kifejezéssel van megadva, így az értékek bármely előző csomópontból átkerülnek, ahogy vannak:

```js
{{ JSON.stringify({ date: $json.date, time: $json.time, timezone: $json.timezone, latitude: $json.latitude, longitude: $json.longitude }) }}
```

## Hogyan számítják a jeleket

Minden mező a **Big three**-ban egy kifejezés. A jel egyenlő a hosszúsággal, elosztva 30-zal és lefelé kerekítve, mint index a listában:

```js
{{ ['Aries','Taurus','Gemini','Cancer','Leo','Virgo','Libra','Scorpio','Sagittarius','Capricorn','Aquarius','Pisces'][Math.floor($json.data.houses.ascendant / 30)] }}
```

A Nap és Hold esetében a hosszúság a `$json.data.planets.find(p => p.name === 'Sun').longitude`-ból jön, és ugyanígy a `'Moon'`-ból.

## Cserélje be az adatait

Cserélje le a **Start** és **Birth data** triggert arra, amit tényleg használ: űrlapra, webhookra vagy táblázat új sorára, és illessze be mezőit a fenti öt névhez. Két dolgot érdemes ellenőrizni:

- **A `timezone` nem lehet üres.** Az üres érték `400` hibával elutasítja, így illessze be a mezőt vagy állítsa be `auto`-ra, ha a koordináták megbízhatóak.
- **A koordináták kötelezőek.** Az API nem geokódolja a város nevét; ha az űrlap csak helyet kér, adjon hozzá egy geokódolási lépést az **AstroWay chart** elé.

<Aside type="note">
A kulcs hatókörön kívüli hívás leállítja a futtatást `403 ENDPOINT_NOT_IN_SCOPE` hibával, a túllépett költségvetésű kulcs `429 KEY_BUDGET_EXHAUSTED` hibával. Mindkettő erre való: emelje a korlátot a dashboardban, ne ismételje meg a kérést.
</Aside>