API di astrologia per siti web e app
Aggiungi la potenza di AstroApp al tuo sito web o alla tua app: API REST e plug-in per WordPress e Joomla per funzionalità selezionate di AstroApp.
Con le API di AstroApp il tuo sito web o la tua app per dispositivi mobili può chiedere ad AstroApp un calcolo astrologico e mostrarne il risultato come parte del tuo prodotto. Puoi scegliere fra tre famiglie di integrazioni API: le API REST, i plug-in per WordPress e Joomla, e le API JavaScript. Tutte girano sulla stessa infrastruttura di AstroApp, in più data center, e sono in grado di gestire carichi continui di milioni di richieste al giorno. Sono disponibili anche la versione white label e la personalizzazione con il tuo marchio.
API REST
Invii i dati del tema in una chiamata REST e ricevi il calcolo che hai richiesto. Le API REST coprono le seguenti funzionalità di AstroApp:
- dati del tema e immagini del tema in diversi stili, occidentali e vedici
- pianeti, asteroidi e planetoidi, case e aspetti, in coordinate geocentriche o topocentriche, con le posizioni eclittiche convertite su richiesta in ascensione retta e declinazione
- rivoluzioni: solari, lunari e planetarie, alle posizioni natali, a una posizione zodiacale data o a una fase
- transiti su un tema natale e transiti sui transiti
- progressioni secondarie e minori, filtrate per intervallo di date, e progressioni agli angoli
- ingressi nei segni, nei nakshatra, nelle dimore lunari, nei termini e nei gradi zodiacali
- la condizione della Luna: vuota di corso, dimora lunare, nakshatra, la fase attuale e la successiva
- dignità essenziali e accidentali, 31 tipi in totale
- statistiche per segno e per casa
- dati di mappatura di AstroCartoGraphy
- luoghi e fusi orari: ricerca su più di cinque milioni di luoghi per città, ospedale o nome del luogo, o per vicinanza a coordinate date. Ogni località fornisce la storia dettagliata dei suoi cambi di fuso orario
Puoi autenticarti con l’autenticazione Basic o con un token. Documentiamo ogni chiamata in una raccolta Postman, con un esempio completo in 30 linguaggi di programmazione, tra cui cURL, PHP, Python, JavaScript, Node, Java e C: documentazione delle API REST di AstroApp. Su GitHub trovi anche un SDK Java, generato dalle stesse definizioni.
API JavaScript
Usa le API JavaScript quando vuoi un tema sulla tua pagina web. Il tuo visitatore inserisce i dati di nascita e il tema compare, in stile occidentale o vedico, senza bisogno di alcuna programmazione lato server da parte tua. La stessa libreria ti dà anche i dati che stanno dietro il tema:
- pianeti: longitudine, latitudine e velocità dei pianeti maggiori, degli asteroidi, dei pianeti ipotetici, della Parte di Fortuna e delle lunazioni prenatali
- cuspidi delle case
- aspetti, con l’indicazione applicativo o separativo e il valore esatto di ciascuno
- il database delle città e quello dei cambi di fuso orario, con la possibilità di cercare per nome e per vicinanza alle coordinate
Alcune funzioni lato client non richiedono alcuna richiesta al server: punti medi, l’aspetto tra due oggetti, la posizione in casa e in segno, le distanze e alcune utilità di formattazione. Puoi limitare una chiave al tuo indirizzo web, così nessuno può copiarla dalla tua pagina e usarla altrove.
Chiavi e utilizzo
Puoi creare e gestire le tue chiavi nel portale di utilizzo delle API all’interno del tuo account AstroApp. Lì puoi anche monitorare l’utilizzo delle tue API.
Le API JavaScript sono incluse nelle edizioni Pro e Financial Gold (solo per uso personale). Le API REST e i plug-in per CMS (Joomla e WordPress) sono un prodotto a parte, con piani di abbonamento propri. Inizi con una quota giornaliera gratuita e un metodo di pagamento registrato, e il tuo account passa automaticamente alla tariffa a consumo la prima volta che superi la tua quota giornaliera gratuita. Per registrarti, visita la sezione API del tuo account AstroApp, dove i piani e le regole di fatturazione sono spiegati per intero.
Domande frequenti
Che cosa restituiscono le API?
JSON per ogni calcolo, e un’immagine quando richiedi un tema. Le API JavaScript offrono gli stessi dati anche come feed XML, se li preferisci.
Mi serve un server per usare le API JavaScript?
No. Per le API JavaScript il server è facoltativo, perché possono funzionare in qualsiasi pagina HTML statica. Quanto alle API REST, le usi dal tuo server o dalla tua app, in qualsiasi linguaggio di programmazione capace di fare una richiesta HTTP.
Posso mostrare il tema in stile vedico?
Sì. Le immagini dei temi e le ruote JavaScript sono disponibili in stile occidentale e vedico, e i calcoli accettano l’ayanamsa e i varga delle impostazioni vediche.
È disponibile un database dei luoghi e delle località geografiche?
Sì. Puoi cercare più di cinque milioni di località per nome e per vicinanza a luoghi geografici indicati, e le ricerche si possono filtrare per paesi e stati. È inclusa la storia di ogni cambio di fuso orario, così un tema per una data passata usa le regole del fuso in vigore in quella data.
Posso presentare i risultati con il mio marchio?
Sì. La versione white label e la personalizzazione con il tuo marchio sono disponibili.
Vedi anche
- Documentazione delle API REST di AstroApp
- Stili di ruota del tema, gli stili di ruota che puoi usare in un’immagine delle API
- Previsione, per le rivoluzioni, i transiti e le progressioni che le API calcolano