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

Catálogo de estrelas fixas

Pesquise o catálogo de estrelas fixas por nome, designação ou brilho. São 1357 linhas para 532 estrelas distintas — as linhas excedentes são nomes alternativos, agrupados na estrela a que pertencem. Isso faz diferença: Aldebaran também é Rohini e Sirius também é Lubdhaka, então os nomes védicos podem ser pesquisados, e uma listagem ingênua retornaria Sirius três vezes. Comece por este índice antes de pedir qualquer outra coisa, porque não há como adivinhar os nomes das estrelas. Ele não recebe data e não retorna posições — uma posição exige uma data; para isso, use /positions/.

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

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

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

Campos da requisição

Campo	Tipo	Obrigatório	Observações
limit	integer	opcional	min 1 · max 500
max_magnitude	number (double)	opcional
preset	string	opcional	`majorbehenianbrightestall`
search	string	opcional	Nome ou designação de Bayer a procurar.

Exemplo de requisição

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

Resposta

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

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.