Salta ai contenuti
AstroWay/api v2.325.0 · it
tutti i sistemi sono operativi

n8n

Last updated Apri come Markdown Configurazione agente

Workflow con quattro nodi: in ingresso dati di nascita, al centro il tema natale con API, in uscita i segni del Sole, Luna e Ascendente. È stato importato in n8n 2.39.7 ed eseguito contro il production il 2026-09-17, e il risultato qui sotto è esattamente quello che ha restituito.

Invece di un HTTP Request manuale, puoi usare il nodo @astroway/n8n-nodes-astroway. Contiene 730 operazioni API come azioni pronte con campi: tema natale, sinastria, transiti, astrologia vedica, Human Design, BaZi, numerologia, tarocchi e altri.

  1. In n8n self-hosted apri Settings → Community Nodes → Install, inserisci @astroway/n8n-nodes-astroway e conferma. n8n ha verificato il nodo il 2026-10-23, quindi in n8n Cloud puoi aggiungerlo dal pannello dei nodi senza installare nulla.
  2. Crea una credential AstroWay API e incolla la chiave. n8n la verifica con la richiesta GET /v1/auth/keys/me, che non consuma crediti. Se la chiave ha un ambito endpoint, aggiungi auth/keys/me, altrimenti la verifica mostrerà Forbidden, anche se le chiamate nell’ambito funzioneranno.
  3. Aggiungi il nodo AstroWay, seleziona il gruppo e l’operazione, ad esempio Core → Natal Chart. I campi obbligatori sono già nell’elenco, quelli opzionali si aggiungono con Add field.

Il nodo restituisce la parte data della risposta, e un errore con codice API, ad esempio INVALID_INPUT. Puoi collegarlo a un AI Agent come strumento.

Qui sotto lo stesso calcolo senza il nodo, con un normale HTTP Request. Funziona in qualsiasi n8n, incluso in Cloud.

Per prima cosa crea una chiave come descritto nella sezione Chiave per automazione, con ambito chart.

La chiave viene salvata nel repository delle credentials di n8n, non nel nodo, quindi non finisce nell’export del workflow.

  1. Crea in n8n una nuova credential di tipo Header Auth.
  2. Name: X-Api-Key.
  3. Value: la tua chiave.
  4. Salvala con il nome AstroWay API key. Il workflow qui sotto cerca la credential proprio con questo nome.

Carica n8n-natal-chart.json, apri un workflow vuoto e incolla il contenuto del file sulla tela o usa l’importazione da file nel menu workflow.

All’interno ci sono quattro nodi:

  • Start, nodo Manual Trigger: avvia il workflow durante il test.
  • Birth data, nodo Edit Fields (Set): date, time, timezone, latitude e longitude di una persona.
  • AstroWay chart, nodo HTTP Request: chiama POST /v1/chart.
  • Big three, nodo Edit Fields (Set): converte le longitudini nei nomi dei segni.

Esegui il workflow. Big three restituisce:

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

offset_used è loffset da UTC che il server ha trovato per Europe/Kyiv il 1990-05-15: 4, non 3, che di solito si inserisce manualmente.

  • Method: POST.

  • URL:

    https://api.astroway.info/v1/chart
  • Authentication: Generic Credential Type.

  • Generic Auth Type: Header Auth, credential AstroWay API key.

  • Send Body: abilitato.

  • Body Content Type: JSON.

  • Specify Body: Using JSON.

Il corpo è definito da un’espressione, quindi i valori da qualsiasi nodo precedente vengono passati così come sono:

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

Ogni campo in Big three è un’espressione. Il segno è uguale alla longitudine divisa per 30 e arrotondata per difetto, come indice nell’elenco:

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

Per Sole e Luna la longitudine viene presa da $json.data.planets.find(p => p.name === 'Sun').longitude e allo stesso modo con 'Moon'.

Sostituisci Start e Birth data con il trigger che usi realmente: un form, un webhook o una nuova riga di tabella, e mappa i suoi campi con i cinque nomi sopra. Due cose da controllare:

  • timezone non può essere vuoto. Un valore vuoto viene rifiutato con 400, quindi mappa un campo o usa auto se le coordinate sono affidabili.
  • Le coordinate sono obbligatorie. L’API non geocodifica il nome della città; se il form chiede solo il luogo, aggiungi un passaggio di geocodifica prima di AstroWay chart.