Integrazioni senza codice

Tutto su queste pagine è stato eseguito contro la produzione del 2026-09-17. I workflow per n8n sono stati importati ed eseguiti in un vero n8n; i passaggi per Zapier e Make sono stati scritti seguendo la documentazione di questi strumenti, e le richieste che essi compongono sono state inviate esattamente in quella forma.

Da dove proviene la richiesta

Da questo dipende quale chiave è necessaria.

• Zapier, Make e n8n lo inviano dai loro server. È necessaria una chiave “Solo server” con ambito endpoint e budget, come descritto di seguito. Istruzioni: Zapier, Make, n8n.
• Bubble invia anche richieste dai suoi server, e la chiave si trova nell’header, dove rimane: Bubble.
• FlutterFlow compila in un’applicazione che l’utente detiene, quindi la chiamata deve essere privata: FlutterFlow.
• Wix, Squarespace, Shopify, Webflow e Tilda mostrano la pagina nel browser del visitatore. Inserisci il widget, non la chiave: costruttori di siti web.
• WordPress si connette dal tuo server. La chiave è gestita dal plugin AstroWay.

Attenzione

La chiave pubblica pk_ non funziona con Zapier, Make o n8n. Rifiuta le richieste senza un origin dalla sua lista, e questi strumenti non inviano un origin. Da una pagina del sito web, funziona solo con un origin dalla sua lista.

Chiave per l’automazione

Chiunque possa modificare uno Zap, uno script o un workflow vede la chiave al suo interno. Pertanto, assegna a ogni automazione la propria chiave e limitane l’uso a ciò che essa fa.

1. Nella dashboard, apri Chiavi API e clicca su Nuova chiave. Chiamala in base all’automazione, ad esempio zapier-intake-form.
2. Nel campo Dove verrà utilizzata questa chiave? lascia Solo server.
3. Copia la chiave e salvala: la finestra di dialogo la mostra completamente una sola volta. Se la chiave viene persa, clicca su Aggiorna chiave nel menu della chiave: ne riceverai una nuova, la vecchia smetterà di funzionare.
4. Nel menu della chiave, apri Ambito degli endpoint ed elenca i percorsi che l’automazione chiama, uno per riga: chart per la carta natale, public/horoscope/* per gli oroscopi giornalieri.
5. Nello stesso menu, apri Imposta budget e specifica quanti crediti questa chiave può spendere per ciclo.

Una chiamata fuori dall’elenco riceve 403 ENDPOINT_NOT_IN_SCOPE. Una chiave che ha esaurito il budget riceve 429 KEY_BUDGET_EXHAUSTED, anche se l’account ha ancora crediti, quindi un’automazione che si è bloccata si fermerà al numero specificato. Entrambe le limitazioni funzionano con qualsiasi piano tariffario e sono descritte nella sezione Autenticazione.

Invia il momento della nascita, non l’offset

Il modulo fornisce data, ora dell’orologio e luogo. Inviali così:

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

• timezone è il nome del fuso orario, e il server trova automaticamente l’offset da UTC che gli orologi mantenevano a quella data, inclusa l’ora legale. Kiev il 1990-05-15 era in UTC+4, non +3: questo è l’errore che un offset inserito manualmente può causare. Invia auto per prendere il fuso orario dalle coordinate.
• Senza timezone e senza offset la carta viene calcolata per UTC. La risposta è comunque 200, quindi verifica che il campo sia mappato.
• Un timezone vuoto viene rifiutato con 400, perché altrimenti un campo del modulo non compilato verrebbe letto come UTC.
• date nel formato YYYY-MM-DD, time nel formato HH:MM:SS. Se il modulo li memorizza diversamente, usa la formattazione della data nello strumento stesso.
• I numeri possono arrivare come testo. "latitude": "50.45" è accettato, ed è così che la maggior parte dei campi dei moduli li invia.
• L’API non geocodifica. Le coordinate devono provenire dal modulo o da un passaggio di geocodifica nello strumento. Il campo city è solo un’etichetta.

Le regole per il cambio dell’ora e le date precedenti al 1970 sono descritte in formati dei campi.

Come convertire le longitudini in segni

POST /v1/chart risponde in gradi lungo lo zodiaco, all’interno di un wrapper { "ok": true, "data": { ... } }. Il segno è uguale a floor(longitude / 30), contando da zero:

0 Ariete, 1 Toro, 2 Gemelli, 3 Cancro, 4 Leone, 5 Vergine, 6 Bilancia, 7 Scorpione, 8 Sagittario, 9 Capricorno, 10 Acquario, 11 Pesci.

Dove si trovano i tre valori più popolari:

• Sole: voce in data.planets con "name": "Sun", la prima.
• Luna: voce in data.planets con "name": "Moon", la seconda.
• Ascendente: data.houses.ascendant.
• Offset utilizzato: data.input.timezoneOffset.

Per l’esempio precedente: Sole 54.34, quindi Toro; Luna 296.39, Capricorno; Ascendente 159.26, Vergine; offset 4.

Quanto costa

• POST /v1/chart costa 20 crediti. La tabella completa si trova sulla pagina Costo degli endpoint.
• La stessa richiesta, inviata di nuovo entro cinque minuti, viene restituita dalla cache e non viene addebitata. Un’esecuzione di prova che ripete lo stesso corpo non consuma il budget.
• GET /v1/public/horoscope/daily non consuma crediti. Senza chiave o con una chiave sul piano Free, viene conteggiato nel limite di 30 richieste all’ora per indirizzo IP, e le piattaforme di automazione condividono i loro indirizzi tra i clienti. Una chiave su un piano a pagamento ha il proprio limite.