Moduli

Le funzionalità di AstroAPI sono organizzate in moduli. Ogni modulo sblocca endpoint API specifici e funzionalità per la tua organizzazione.

Categorie di Moduli

Categoria	Descrizione
calc	Moduli di calcolo — endpoint di calcolo API
texts	Moduli di testo per contenuti/interpretazioni
charts	Moduli di rendering dei temi
addon	Funzionalità aggiuntive
admin	Strumenti di amministrazione/gestione

Moduli Disponibili

ID Modulo	Categoria	Descrizione
module:natal	calc + texts + charts	Calcoli tema natale, interpretazioni e rendering
module:natal-calc	calc	Solo calcoli tema natale
module:synastry	calc + texts + charts	Calcoli sinastria, interpretazioni e temi
module:synastry-calc	calc	Solo calcoli sinastria
module:transit	calc + texts + charts	Calcoli transiti, interpretazioni e temi
module:transit-calc	calc	Solo calcoli transiti
module:composite	calc + texts + charts	Calcoli tema composito, interpretazioni e temi
module:composite-calc	calc	Solo calcoli composito
module:progression	calc	Progressioni secondarie
module:solar-return	calc + texts + charts	Rivoluzione solare con interpretazioni e temi
module:solar-return-calc	calc	Solo calcoli rivoluzione solare
module:lunar-return	calc + texts + charts	Rivoluzione lunare con interpretazioni e temi
module:lunar-return-calc	calc	Solo calcoli rivoluzione lunare
module:chinese-horoscope	calc	Calcolo segno zodiacale cinese
module:chinese-forecast	calc	Previsione annuale cinese
module:compatibility	calc	Compatibilità astrologica
module:moon	calc	Calcoli Luna/Sole e calendario lunare
module:retrograde	calc	Calcoli periodi retrogradazione
module:numerology	calc	Calcoli numerologici
module:daily-report	texts	Rapporti oroscopo giornaliero
module:weekly-report	texts	Rapporti oroscopo settimanale
module:yearly-report	texts	Rapporti oroscopo annuale
module:yearly-ascendant-report	texts	Rapporti oroscopo annuale dell'ascendente
module:extra-language	addon	Supporto per lingue aggiuntive
module:ai-addon	addon	Funzionalità chatbot con IA
module:embeddable-widgets	addon	Supporto per widget incorporabili
module:content-editor	admin	Accesso all'editor di contenuti

Piani di Abbonamento

Ogni piano di abbonamento include un insieme fisso di moduli. Tutti i prezzi includono uno sconto del 20%. I moduli "Full" includono calc + texts + charts. I moduli "Calc" includono solo i calcoli.

Funzionalità	Basic (€49,99/mese)	Gold (€112,49/mese)	Premium (€249,99/mese)	Deluxe (€374,99/mese)
Limite utilizzo	60 req/min	120 req/min	300 req/min	600 req/min
Richieste mensili	150K	300K	750K	1M
Natale (calc)	✅	✅	✅	✅
Compatibilità	✅	✅	✅	✅
Luna/Sole	✅	✅	✅	✅
Numerologia	✅	✅	✅	✅
Editor Contenuti		✅	✅	✅
Natale (full)		✅	✅	✅
Transiti (calc)			✅	✅
Rivoluzione Solare/Lunare (calc)			✅	✅
Sinastria/Composito (calc)			✅	✅
Progressioni			✅	✅
Oroscopo Cinese			✅	✅
Retrogradazione			✅	✅
Widget Incorporabili			✅	✅
Transiti (full)				✅
Rivoluzione Solare/Lunare (full)				✅
Sinastria/Composito (full)				✅
Previsione Cinese				✅
Rapporti Giornalieri/Settimanali/Annuali				✅

Verifica dell'Accesso ai Moduli

Elenca tutti i moduli disponibili per la tua organizzazione:

curl -X GET "https://api.astroapi.cloud/api/modules" \
  -H "X-Api-Key: your-api-key"

Risposta

{
  "data": [
    {
      "type": "module",
      "id": "module:natal-calc",
      "attributes": {
        "name": "Natal Chart Calculations",
        "enabled": true,
        "expiresAt": null
      }
    },
    {
      "type": "module",
      "id": "module:transit-calc",
      "attributes": {
        "name": "Transit Calculations",
        "enabled": true,
        "expiresAt": "2024-12-31T23:59:59Z"
      }
    }
  ]
}

Endpoint con Accesso Limitato ai Moduli

Quando accedi a un endpoint che richiede un modulo che non possiedi:

{
  "errors": [{
    "status": "403",
    "title": "Module Required",
    "detail": "This endpoint requires the 'module:synastry-calc' module.",
    "meta": {
      "requiredModule": "module:synastry-calc"
    }
  }]
}

Permessi delle Chiavi API

Le chiavi API possono essere limitate a moduli specifici. Anche se la tua organizzazione ha accesso a un modulo, le singole chiavi API possono essere configurate per escluderlo:

{
  "apiKey": {
    "modules": ["module:natal-calc", "module:moon"]
  }
}

Questo ti consente di creare chiavi con ambito limitato per casi d'uso specifici, ad esempio una chiave che consente solo i calcoli del tema natale senza accesso ad altri moduli a cui la tua organizzazione è abbonata.