Progressions
API des progressions astrologiques
BêtaL’API des progressions permet de calculer des thèmes progressés, de rechercher des aspects exacts sur une période et de créer des calendriers d’événements selon cinq systèmes : secondaire, secondaire converse, tertiaire, quotidien et quaternaire.
Tous les endpoints de progressions sont encore en bêta. La sélection et le classement des événements, ainsi que certains détails des réponses, peuvent évoluer pendant la stabilisation du contrat.
Démarrage rapide
Si vous découvrez les progressions, commencez par le calcul du thème secondaire. Ce système courant offre un point de départ simple avant les recherches d’événements et les calendriers.
Chaque endpoint de calcul de thème utilise le même bloc natal . Seuls la route et le nom du bloc de progression changent, par exemple secondary_progression ou tertiary_progression.
curl -X POST "https://api.freeastroapi.com/api/v1/western/progressions/secondary" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"natal": {
"name": "User",
"datetime": "1990-01-01 12:00",
"time_known": true,
"location": {
"city": "London",
"lat": 51.5074,
"lng": -0.1278,
"tz_str": "AUTO"
}
},
"secondary_progression": {
"target_date": "2026-03-30"
}
}'Vous cherchez la règle « 1 an = 1 degré » ?
Cette technique est décrite dans les directions symboliques. Utilisez-la pour appliquer la clé zodiacale fixe de Ptolémée : method=zodiacal, direction=directet key=ptolemy.
Quel endpoint choisir ?
Obtenir un thème progressé
Utilisez une route de calcul de thème. Commencez par les progressions secondaires, sauf si vous avez déjà choisi un autre système.
Rechercher des aspects exacts sur une période
Utilisez la recherche d’aspects exacts pour dater les contacts entre positions progressées et natales, ou entre positions progressées.
Repérer les changements de signe ou de maison
Utilisez la recherche d’entrées exactes pour repérer les changements de signe ou de maison sur une période.
Obtenir un calendrier d’événements
Utilisez les calendriers pour obtenir une sélection des prochains aspects exacts, entrées, stations et phases lunaires.
Choisir un système de progression
Secondaires
La progression classique d’un jour pour un an. Le choix par défaut pour obtenir le thème progressé standard utilisé par la plupart des astrologues.
Secondaires converses
Le même principe que les progressions secondaires, en remontant avant la naissance. Utile pour les recherches spécialisées ou les techniques symboliques converses.
Tertiaires
Une progression plus rapide fondée sur le mois lunaire, adaptée aux cycles symboliques plus courts que ceux des progressions secondaires.
Quotidiennes
Une progression symbolique fondée sur un arc solaire. Elle convient pour obtenir un thème dirigé à partir d’un arc explicite plutôt que d’une date progressée.
Quaternaires
Un système symbolique plus rapide fondé sur la correspondance d’un mois lunaire pour un an, adapté aux cycles courts et à l’expérimentation.
Choisir une opération
Calcul de thème
Consultez la page du système choisi pour obtenir un thème progressé complet ou utiliser response_mode=table.
Recherche et calendrier
Consultez les pages communes pour les entrées exactes, les aspects exacts et les calendriers. Le modèle de route est identique pour les cinq systèmes.
Gestion des fuseaux horaires
Les progressions utilisent la structure natale imbriquée récente, y compris sa gestion du fuseau horaire de naissance.
- Sans
target_location: les dates seules et les dates-heures sans fuseau explicite sont interprétées en UTC. - Avec
target_location: les dates seules et les dates-heures sans fuseau explicite sont interprétées dans ce fuseau local. target_location.tz_str = "AUTO"est résolu à partir de la ville et des coordonnées cibles.
Cela s’applique au paramètre target_date, aux périodes de recherche exacte et aux périodes des calendriers.