POST/api/astro/fixed-star/catalog/1 Credit

Fixsternkatalog

Durchsucht den Fixsternkatalog nach Name, Bezeichnung oder Helligkeit. 1357 Zeilen für 532 verschiedene Sterne – die übrigen sind Aliasnamen und werden dem jeweiligen Stern zugeordnet. Das ist hier wichtig: Aldebaran heißt auch Rohini und Sirius auch Lubdhaka, die vedischen Namen sind also durchsuchbar, und eine naive Auflistung würde Sirius dreimal liefern. Diesen Index brauchst du vor jeder anderen Abfrage, denn Sternnamen lassen sich nicht erraten. Er braucht kein Datum und liefert keine Positionen – für eine Position braucht es ein Datum, dafür ist /positions/ da.

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

Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

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

Felder der Anfrage

Feld	Typ	Pflicht	Hinweise
limit	integer	optional	min 1 · max 500
max_magnitude	number (double)	optional
preset	string	optional	`majorbehenianbrightestall`
search	string	optional	Nach einem Namen oder einer Bayer-Bezeichnung suchen.

Beispielanfrage

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}'

Antwort

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

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.