Desarrolladores · API v1
La API pública de Molino
El mismo motor de cálculo de la app, para tus aplicaciones, bots o sitios. Gratis, con CORS abierto y sin registro.
Una consulta de ejemplo
curl "https://www.molino.app/api/v1/map?date=1990-03-15"
"map": {
"numerology": { "lifePath": 1 },
"astrology": { "sunSign": "Piscis" },
"chineseZodiac": { "animal": "Caballo" },
...
}Sin guardado
Las consultas no guardan estado: no persistimos fechas ni identificadores en servidores.
CORS abierto
Se consume directo desde el navegador con fetch, o desde backends en Node o Python.
Determinista
Los mismos parámetros devuelven siempre exactamente el mismo resultado.
Endpoints
GET/api/v1/map
Mapa Personal CompletoCalcula Camino de Vida, signo solar, animal del zodíaco chino y ciclos anuales.
Parámetros de consulta (Query Params)
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| date | string (YYYY-MM-DD) | Sí | Fecha de nacimiento (ej: 1990-03-15) |
| name | string | Opcional | Nombre opcional del consultante |
Ejemplo de respuesta (JSON):Probar en vivo
{
"status": "success",
"query": { "date": "1990-03-15", "name": "Ana" },
"map": {
"numerology": { "lifePath": 1, "archetype": "El Iniciador" },
"astrology": { "sunSign": "Piscis", "element": "Agua" },
"chineseZodiac": { "animal": "Caballo", "element": "Metal" },
"cycles": { "personalYear": 9, "personalDay": 1 }
}
}GET/api/v1/daily
Energía & Foco DiarioCalcula la vibración diaria, fase lunar, áreas de foco y recomendaciones.
Parámetros de consulta (Query Params)
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| birthDate | string (YYYY-MM-DD) | Sí | Fecha de nacimiento |
| targetDate | string (YYYY-MM-DD) | Opcional | Fecha a consultar (default: hoy) |
Ejemplo de respuesta (JSON):Probar en vivo
{
"status": "success",
"dailyEnergy": {
"personalDay": 1,
"theme": "Iniciación",
"moonPhase": { "phase": "Luna Nueva", "emoji": "🌑" },
"areas": { "work": { "score": 85 }, "creativity": { "score": 90 } }
}
}GET/api/v1/compatibility
Compatibilidad & SinastríaCruza dos mapas para obtener puntuación de sinastría, conexiones y desafíos.
Parámetros de consulta (Query Params)
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| dateA | string (YYYY-MM-DD) | Sí | Fecha nacimiento persona A |
| dateB | string (YYYY-MM-DD) | Sí | Fecha nacimiento persona B |
Ejemplo de respuesta (JSON):Probar en vivo
{
"status": "success",
"compatibility": {
"score": 88,
"level": "Alta Resonancia",
"summary": "Excelente equilibrio entre agua y fuego.",
"connections": [...]
}
}