API Étoiles fixes

À partir de la date, l'heure, le décalage UTC et les coordonnées de naissance fournies, le endpoint calcule les points natals puis parcourt le catalogue des étoiles fixes majeures tiré de la tradition Vivian Robson et Ptolémée – les étoiles brillantes et astrologiquement pondérées plutôt que tout le ciel. Pour chaque étoile, il teste les points natals à la recherche d’une conjonction, et lorsqu’une se trouve dans l’orb, il enregistre le contact avec l’orb exact de séparation. Le résultat sous data.stars est une liste de correspondances étoile-point : quelle étoile, quel point natal elle touche, et à quel point l’alignement est proche, ainsi une conjonction d’un demi-degré est lue comme plus puissante qu’une à la limite de l’orb. Seules les conjonctions sont prises en compte – la technique considère une étoile comme significative lorsqu’un point de la carte se trouve dessus, pas lorsqu’elle forme les angles longitudinaux que les planètes font entre elles. Cela fait apparaître les étoiles nommées que les sources classiques ont désignées comme favorables ou dangereuses, prêtes à être associées à ton propre texte d’interprétation d’étoile.

curl -X POST https://api.astroway.info/v1/fixed-stars \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}'

{
  "ok": true,
  "data": {
    "stars": [
      {
        "star": "Regulus",
        "point": "Mercury",
        "orb": 0.4
      },
      {
        "star": "Algol",
        "point": "Mars",
        "orb": 1.1
      }
    ]
  }
}

Utilise ce endpoint quand une lecture de carte veut la texture supplémentaire des étoiles nommées – un interprète traditionnel ou sensible aux étoiles fixes, un générateur de rapport qui signale un contact frappant avec Algol ou l’étoile royale Régulus, ou un outil éducatif qui enseigne le folklore derrière les étoiles les plus brillantes. Le design à orb serré, uniquement conjonctions, garde la sortie ciblée : tu obtiens la poignée de contacts qui valent la peine d’être mentionnés plutôt que du bruit, ce qui facilite l’affichage sous forme de courte liste mise en avant. Fournis les mêmes données de naissance que tu as envoyées au endpoint natal-chart et les hits d’étoiles s’aligneront avec les positions planétaires et angulaires déjà présentes dans ta carte, te permettant d’annoter une planète ou un angle avec son étoile co-localisée. Parce que le catalogue est curaté aux étoiles traditionnellement significatives, tu peux attacher un texte interprétatif préparé à chaque étoile sans devoir le curer toi-même.

Le catalogue des étoiles suit la sélection transmise par Vivian Robson et Ptolémée – les étoiles fixes astrologiquement majeures, pas un relevé complet du ciel. Les positions natales et les longitudes des étoiles sont calculées par le moteur Swiss Ephemeris (Astrodienst) dans le zodiaque tropical, et seules les conjonctions dans l’orb sont renvoyées.