# n8n

Workflow cu patru noduri: la intrare datele de naștere, în mijloc harta natală din API, la ieșire semnele Soarelui, Lunii și Ascendentului. A fost importat în n8n 2.39.7 și rulat împotriva producției pe 2026-09-17, iar rezultatul de mai jos este exact cel pe care l-a returnat.

## Nodul AstroWay

În loc de un HTTP Request manual poți adăuga nodul [`@astroway/n8n-nodes-astroway`](https://www.npmjs.com/package/@astroway/n8n-nodes-astroway). Acesta conține 730 de operații API ca acțiuni predefinite cu câmpuri: hartă natală, sinastrie, tranzite, astrologie vedică, Human Design, BaZi, numerologie, tarot și altele.

1. În n8n self‑hosted deschide **Settings → Community Nodes → Install**, introdu `@astroway/n8n-nodes-astroway` și confirmă. n8n a verificat nodul pe 2026-10-23, așa că în n8n Cloud îl poți adăuga din panoul de noduri fără nicio instalare.
2. Creează credential **AstroWay API** și inserează cheia. n8n o verifică cu cererea `GET /v1/auth/keys/me`, care nu consumă credite. Dacă cheia are o zonă de endpointuri, adaugă `auth/keys/me` la ea, altfel verificarea va arăta `Forbidden`, deși apelurile din zonă vor funcționa.
3. Adaugă nodul **AstroWay**, selectează grupul și operația, de exemplu **Core → Natal Chart**. Câmpurile obligatorii sunt deja în listă, cele opționale se adaugă prin **Add field**.

Nodul returnează o parte a răspunsului `data` și o eroare cu codul API, de exemplu `INVALID_INPUT`. Poate fi conectat la AI Agent ca instrument.

Mai jos aceeași calculare fără nod, cu un HTTP Request obișnuit. Funcționează în orice n8n, inclusiv în Cloud.

Mai întâi creează cheia, așa cum este descris în secțiunea [Cheie pentru automatizare](/integrations/#cheie-pentru-automatizare), cu zona `chart`.

## 1. Adaugă cheia ca credential

Cheia este stocată în depozitul de credentials n8n, nu în nod, așa că nu ajunge în workflow‑ul exportat.

1. În n8n creează un nou credential de tip **Header Auth**.
2. **Name**: `X-Api-Key`.
3. **Value**: cheia ta.
4. Salvează-l sub numele **AstroWay API key**. Workflow‑ul de mai jos caută credentialul exact cu acest nume.

## 2. Importă workflow

Descarcă [n8n-natal-chart.json](/integrations/n8n-natal-chart.json), deschide un workflow gol și inserează conținutul fișierului pe pânză sau folosește importul din fișier din meniul workflow.

În interior sunt patru noduri:

- **Start**, nod Manual Trigger: pornește workflow‑ul în timpul testului.
- **Birth data**, nod Edit Fields (Set): `date`, `time`, `timezone`, `latitude` și `longitude` ale unei persoane.
- **AstroWay chart**, nod HTTP Request: apelează `POST /v1/chart`.
- **Big three**, nod Edit Fields (Set): transformă longitudinile în numele semnelor.

## 3. Rulează

Execută workflow‑ul. **Big three** returnează:

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

`offset_used` este decalajul față de UTC pe care serverul l‑a găsit pentru `Europe/Kyiv` la 1990-05-15: 4, nu 3, cum se scrie de obicei manual.

## Cum este configurat nodul HTTP Request

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

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

- **Authentication**: Generic Credential Type.
- **Generic Auth Type**: Header Auth, credential **AstroWay API key**.
- **Send Body**: activat.
- **Body Content Type**: JSON.
- **Specify Body**: Using JSON.

Corpul este setat prin expresie, astfel valorile din orice nod anterior sunt transmise așa cum sunt:

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

## Cum se calculează semnele

Fiecare câmp din **Big three** este o expresie. Semnul este egal cu longitudinea împărțită la 30 și rotunjită în jos, ca index într-o listă:

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

Pentru Soare și Lună longitudinea se ia din `$json.data.planets.find(p => p.name === 'Sun').longitude` și la fel din `'Moon'`.

## Înlocuiește cu datele tale

Înlocuiește **Start** și **Birth data** cu triggerul pe care îl folosești cu adevărat: formular, webhook sau un nou rând de tabel, și potrivește câmpurile lui cu cele cinci nume de mai sus. Două lucruri de verificat:

- **`timezone` nu poate fi gol.** O valoare goală este respinsă cu `400`, așa că potrivește câmpul sau setează `auto` dacă coordonatele sunt de încredere.
- **Coordonatele sunt obligatorii.** Apelul hărții nu geocodează numele orașului; dacă formularul cere doar locația, adaugă înainte de **AstroWay chart** un HTTP Request către `GET /v1/geo/search?q=...` și preia `latitude`, `longitude` și `timezone` din primul rezultat ([Căutare locuri](/geo/); adaugă `geo/search` la zona de acțiune a cheii).

**Note:**
Apelul în afara zonei cheii oprește rularea cu `403 ENDPOINT_NOT_IN_SCOPE`, iar cheia depășind bugetul dă `429 KEY_BUDGET_EXHAUSTED`. Ambele sunt pentru asta: crește limita în dashboard, nu repeta cererea.
