Ir para o conteúdo

Erros comuns

Os LLMs costumam gerar código quebrado exatamente destes jeitos. Conferido com os logs de produção.

Astrologia

  • O horóscopo é POST /api/astro/rashifal/daily/ com o corpo JSON { rashi }, por exemplo { "rashi": "aries" }. Não é GET nem parâmetro de caminho.
  • O mapa natal é POST /api/astro/chart/. Exige ayanamsa, chart_name, datetime, latitude, longitude e notation.
  • A resposta do horóscopo diário (rashifal) inclui os campos general_prediction, aspects (com love, career, health) e lucky (com color, number). Não existem os campos column, overview nem events.

Védica

  • O corpo usa date_time (string ISO 8601), latitude, longitude e timezone_as_float. Data e hora não vão em campos separados.
  • Manglik dosha: a chave manglik retorna uma lista de três elementos [is_manglik, cancellation_applied, cancellation_rules_matched], e não um booleano.
  • Kala Sarpa: a chave kala_sarpa retorna um booleano. Use o endpoint astro/dosha/ com keys: [\"kala_sarpa\"].
  • Endpoint de dasha: POST /api/astro/dasha/vimshottari/. Recebe date_time, latitude, longitude e timezone_as_float. Não existe endpoint separado para sub-dashas.
  • O mapa KP é POST /api/astro/kp-chart/, e não /kp/birth-chart.
  • Panchang: use GET panchanga com date_time, latitude, longitude e timezone_as_float.

Numerologia

  • A numerologia usa date_time, name, year, month e day (inteiros), e não uma string birthDate.
  • O array keys define quais cálculos voltam na resposta. Junte todas as chaves numa chamada só — custa um crédito, seja qual for a quantidade.
  • Chave do ano pessoal: personal_year_number, com o parâmetro year (o padrão é o ano atual).

Tarô

  • Tiragem: POST /api/astro/tarot/spread/ com o parâmetro spread (por exemplo, three_card), e não /spreads/three-card.
  • Sim/Não: POST /api/astro/tarot/yes-no/. O campo da resposta é strength (não confidence). Valores possíveis: só "Strong" ou "Qualified".
  • Tirar cartas: POST /api/astro/tarot/draw/.
  • Os IDs das cartas usam kebab-case: fool, ace-of-cups, three-of-swords.

I Ching

  • O I Ching é POST /api/astro/numerology/iching/. Recebe date_time e name, ambos opcionais. Não existem endpoints separados de daily ou cast.

Números angelicais

  • POST /api/astro/numerology/angel/ com sequence como string (por exemplo, "1111"). Um inteiro é recusado na validação.

Todos os endpoints

  • Em todos os endpoints POST, inclua o cabeçalho Content-Type: application/json.

Uso do SDK

  • TypeScript: inicialize com new OccultApi({ apiKey }). Todo método retorna { data, error, response }. Verifique error primeiro.
  • Python: from occult_api import OccultApi; passe kwargs, nunca argumentos posicionais. As variantes assíncronas terminam em _async.
  • PHP (8.2+): use function OccultAPI\Sdk\occult; e depois $occult = occult($key). Chame os métodos com argumentos nomeados.
  • Nunca chame a Occult API em código que roda no cliente. Chave de API fica no servidor.

Próximos passos