POST/api/astro/dasha/drill/1 crédito

Detalhamento de dasha

Um ramo de uma árvore de dasha, em vez da árvore inteira. Nos outros endpoints de dasha, levels limita a PROFUNDIDADE, mas ainda retorna todos os períodos nessa profundidade: levels=3 no Vimshottari significa todos os pratyantardashas sob todos os antardashas sob todos os mahadashas, cerca de 95 KB. Uma tela em que alguém toca em um mahadasha para expandi-lo só precisa de um ramo disso. Informe a cadeia de senhores a seguir, e este endpoint retorna só o que está sob o período indicado. {"lords": ["moon", "mars"], "levels": 1} retorna os pratyantardashas dentro do antardasha de Marte do mahadasha da Lua — cerca de 1.8 KB, contra os 95 KB da árvore que o contém. Os nomes dos senhores são comparados sem diferenciar maiúsculas de minúsculas, e path na resposta devolve a cadeia que de fato foi encontrada. Use um nome de planeta para os dashas nakshatra e um nome de signo para os dashas rashi de Jaimini; um senhor não reconhecido retorna 400, com a lista do que estava disponível naquele nível. Isso economiza TRANSFERÊNCIA, não CÁLCULO. O motor continua construindo a árvore até a profundidade pedida, e este endpoint descarta o resto; por isso, um detalhamento não é mais rápido de calcular do que a chamada equivalente com levels=. O que ele economiza é largura de banda, parse de JSON e a memória que um navegador ou celular gasta para guardar uma árvore da qual mostra só um ramo.

https://api.occultapi.com/api/astro/dasha/drill/

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
latitude	number (double)	obrigatório	Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. min -90 · max 90
longitude	number (double)	obrigatório	Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. min -180 · max 180
dasha_direction	string	opcional	`forwardbackward`
dasha_start	string	opcional	Ciclo em que a linha do tempo começa. `currentnextprevious`
date_time	string (date-time)	opcional	O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes.
datetime	string (date-time)	opcional	O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC. Equivale a date_time, nome que outros endpoints usam para o mesmo valor.
days_in_year	number (double)	opcional	Duração do ano usada para medir os períodos. 360 para o ano savana clássico, 365.25 para o ano juliano. min 360 · max 365.256364
levels	integer	opcional	Número de níveis ABAIXO do período localizado a retornar. 1 retorna os filhos diretos. min 1 · max 4
lords	array	opcional	A cadeia de senhores de período a seguir a partir do topo, começando pelo mais externo — por exemplo, ["moon", "mars"] significa "dentro do mahadasha da Lua, dentro do seu antardasha de Marte". Um nome de planeta para dashas nakshatra, um nome de signo para dashas rashi. Vazio retorna o nível superior.
node	string	opcional	Modelo do nodo lunar. Obrigatório no endpoint pai de rashi, que não define um padrão; aqui, há um padrão. `truemean`
system	string	opcional	Sistema de dasha. Veja /api/astro/dasha/systems/. Padrão: Vimshottari.
timezone_as_float	number (double)	opcional	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. min -12 · max 14

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/dasha/drill/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"dasha_direction":"forward","dasha_start":"current","date_time":"2026-09-01 06:00:00","node":"true","timezone_as_float":5.5}'

Resposta

{
  "data": {
    "system": "Vimshottari",
    "engine_id": "VimshottariDasha",
    "family": "nakshatra",
    "lord_type": "planet",
    "levels": 1,
    "level_names": [
      "mahadasha"
    ],
    "cycle_years": 120,
    "conditional": false,
    "path": [],
    "depth": 0,
    "child_level": "mahadasha",
    "periods": [
      {
        "lord": "ketu",
        "start": "2025-11-21 14:30:19.062048+00:00",
        "end": "2032-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "venus",
        "start": "2032-11-21 08:30:19.062048+00:00",
        "end": "2052-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "sun",
        "start": "2052-11-21 08:30:19.062048+00:00",
        "end": "2058-11-21 20:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "moon",
        "start": "2058-11-21 20:30:19.062048+00:00",
        "end": "2068-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "mars",
        "start": "2068-11-21 08:30:19.062048+00:00",
        "end": "2075-11-22 02:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "rahu",
        "start": "2075-11-22 02:30:19.062048+00:00",
        "end": "2093-11-21 14:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "jupiter",
        "start": "2093-11-21 14:30:19.062048+00:00",
        "end": "2109-11-22 14:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "saturn",
        "start": "2109-11-22 14:30:19.062048+00:00",
        "end": "2128-11-22 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "mercury",
        "start": "2128-11-22 08:30:19.062048+00:00",
        "end": "2145-11-22 14:30:19.062048+00:00",
        "children": []
      }
    ],
    "metadata": {
      "calculation_time_ms": 0,
      "max_levels": 1,
      "data_size_bytes": 1171,
      "data_size_mb": 0,
      "structure": "nested_hierarchical"
    },
    "boundary_note": "The last sub-period of each period ends 18 hours before its parent does. Sibling periods are contiguous and the first child starts with its parent, but the final 18 hours of every period have no sub-period covering them. This comes from the calculation engine and is reported rather than hidden."
  },
  "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.