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) elucky(com color, number). Não existem os camposcolumn,overviewnemevents.
Védica
- O corpo usa
date_time(string ISO 8601),latitude,longitudeetimezone_as_float. Data e hora não vão em campos separados. - Manglik dosha: a chave
manglikretorna uma lista de três elementos [is_manglik, cancellation_applied, cancellation_rules_matched], e não um booleano. - Kala Sarpa: a chave
kala_sarparetorna um booleano. Use o endpointastro/dosha/comkeys: [\"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 panchangacom date_time, latitude, longitude e timezone_as_float.
Numerologia
- A numerologia usa
date_time,name,year,montheday(inteiros), e não uma stringbirthDate. - O array
keysdefine 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âmetroyear(o padrão é o ano atual).
Tarô
- Tiragem:
POST /api/astro/tarot/spread/com o parâmetrospread(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ãoconfidence). 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/comsequencecomo 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.