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

Catálogo de estrellas fijas

Busca en el catálogo de estrellas fijas por nombre, designación o brillo. 1357 filas que corresponden a 532 estrellas distintas: el resto son nombres alternativos, agrupados en la estrella a la que pertenecen. Y esto importa: Aldebaran es también Rohini y Sirius es también Lubdhaka, así que se puede buscar por los nombres védicos, y un listado sin agrupar devolvería Sirius tres veces. Es el índice que necesitas antes de pedir cualquier otra cosa, porque los nombres de las estrellas no se pueden adivinar. No recibe fecha ni devuelve posiciones: una posición necesita una fecha, así que para eso usa /positions/.

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

Probar solicitud

Autenticación

Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.

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

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
limit	integer	opcional	min 1 · max 500
max_magnitude	number (double)	opcional
preset	string	opcional	`majorbehenianbrightestall`
search	string	opcional	Nombre o designación de Bayer que se busca.

Ejemplo de solicitud

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

Respuesta

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

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.

Errores

Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.