Módulos

Las funcionalidades de AstroAPI están organizadas en módulos. Cada módulo desbloquea endpoints de API y funcionalidades específicas para vuestra organización.

Categorías de Módulos

Categoría	Descripción
calc	Módulos de cálculo — endpoints de cómputo de la API
texts	Módulos de textos de contenido e interpretación
charts	Módulos de renderizado de cartas
addon	Funcionalidades adicionales
admin	Herramientas de administración y gestión

Módulos Disponibles

ID del Módulo	Categoría	Descripción
module:natal	calc + texts + charts	Cálculos de carta natal, interpretaciones y renderizado de cartas
module:natal-calc	calc	Solo cálculos de carta natal
module:synastry	calc + texts + charts	Cálculos de sinastría, interpretaciones y cartas
module:synastry-calc	calc	Solo cálculos de sinastría
module:transit	calc + texts + charts	Cálculos de tránsitos, interpretaciones y cartas
module:transit-calc	calc	Solo cálculos de tránsitos
module:composite	calc + texts + charts	Cálculos de carta compuesta, interpretaciones y cartas
module:composite-calc	calc	Solo cálculos compuestos
module:progression	calc	Progresiones secundarias
module:solar-return	calc + texts + charts	Retorno solar con interpretaciones y cartas
module:solar-return-calc	calc	Solo cálculos de retorno solar
module:lunar-return	calc + texts + charts	Retorno lunar con interpretaciones y cartas
module:lunar-return-calc	calc	Solo cálculos de retorno lunar
module:chinese-horoscope	calc	Cálculo del signo zodiacal chino
module:chinese-forecast	calc	Pronóstico anual chino
module:compatibility	calc	Compatibilidad astrológica
module:moon	calc	Cálculos de Luna/Sol y calendario lunar
module:retrograde	calc	Cálculos de períodos retrógrados
module:numerology	calc	Cálculos de numerología
module:daily-report	texts	Informes de horóscopo diario
module:weekly-report	texts	Informes de horóscopo semanal
module:yearly-report	texts	Informes de horóscopo anual
module:yearly-ascendant-report	texts	Informes de horóscopo anual del ascendente
module:extra-language	addon	Soporte de idiomas adicionales
module:ai-addon	addon	Funcionalidades de chatbot con IA
module:embeddable-widgets	addon	Soporte para widgets embebidos
module:content-editor	admin	Acceso al editor de contenido

Planes de Suscripción

Cada plan de suscripción incluye un conjunto fijo de módulos. Todos los precios incluyen un descuento del 20%. Los módulos "completos" incluyen calc + texts + charts. Los módulos "Calc" incluyen solo cálculos.

Funcionalidad	Basic (49,99 €/mes)	Gold (112,49 €/mes)	Premium (249,99 €/mes)	Deluxe (374,99 €/mes)
Límite de uso	60 sol/min	120 sol/min	300 sol/min	600 sol/min
Solicitudes mensuales	150K	300K	750K	1M
Natal (calc)	✅	✅	✅	✅
Compatibilidad	✅	✅	✅	✅
Luna/Sol	✅	✅	✅	✅
Numerología	✅	✅	✅	✅
Editor de Contenido		✅	✅	✅
Natal (completo)		✅	✅	✅
Tránsito (calc)			✅	✅
Retorno Solar/Lunar (calc)			✅	✅
Sinastría/Compuesto (calc)			✅	✅
Progresiones			✅	✅
Horóscopo Chino			✅	✅
Retrógrado			✅	✅
Widgets Embebidos			✅	✅
Tránsito (completo)				✅
Retorno Solar/Lunar (completo)				✅
Sinastría/Compuesto (completo)				✅
Pronóstico Chino				✅
Informes Diarios/Semanales/Anuales				✅

Comprobar Acceso a Módulos

Listado de todos los módulos disponibles para vuestra organización:

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

Respuesta

{
  "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"
      }
    }
  ]
}

Endpoints Bloqueados por Módulo

Cuando accedáis a un endpoint que requiere un módulo que no tenéis:

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

Permisos de Claves de API

Las claves de API pueden restringirse a módulos específicos. Aunque vuestra organización tenga acceso a un módulo, las claves de API individuales pueden configurarse para excluirlo:

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

Esto os permite crear claves con alcance limitado para casos de uso específicos, como una clave que solo permita cálculos de carta natal sin acceso a otros módulos a los que vuestra organización está suscrita.