POST/api/astro/fixed-star/catalog/1 crédit

Catalogue des étoiles fixes

Recherchez dans le catalogue des étoiles fixes par nom, désignation ou éclat. 1357 lignes pour 532 étoiles distinctes — les autres lignes sont des alias, rattachés à leur étoile. Ce point compte : Aldébaran est aussi Rohini et Sirius aussi Lubdhaka, si bien que les noms védiques sont consultables, alors qu’une liste naïve renverrait Sirius trois fois. C’est l’index à consulter avant toute autre requête, car les noms d’étoiles ne se devinent pas. Il ne prend pas de date et ne renvoie aucune position — une position dépend d’une date : pour cela, utilisez /positions/.

https://api.occultapi.com/api/astro/fixed-star/catalog/

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Champs de la requête

Champ	Type	Obligatoire	Remarques
limit	integer	facultatif	min 1 · max 500
max_magnitude	number (double)	facultatif
preset	string	facultatif	`majorbehenianbrightestall`
search	string	facultatif	Rechercher un nom ou une désignation de Bayer.

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/fixed-star/catalog/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search":"aldebaran","preset":"all","limit":25}'

Réponse

{
  "data": {
    "distinct_stars": 532,
    "matched": 1,
    "returned": 1,
    "stars": [
      {
        "star": "Aldebaran",
        "designation": "alTau",
        "magnitude": 0.86,
        "aliases": [
          "Rohini"
        ]
      }
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.