/api/astro/astrocartography/lines/1 créditoLinhas de astrocartografia
Todas as linhas de astrocartografia de um momento de nascimento, como coordenadas prontas para plotar em um mapa. A astrologia de relocalização faz uma pergunta geográfica, e não sobre o mapa astrológico: não onde um planeta estava no céu, mas em quais lugares da Terra ele estava nascendo, se pondo, culminando ou no nadir no momento do nascimento. Essas quatro curvas por planeta, desenhadas em um mapa-múndi, formam o mapa ACG. Para cada um dos doze corpos, você recebe quatro linhas. As linhas MC e IC são meridianos, então cada uma é uma única longitude. As linhas AC e DC são curvas e vêm como uma lista de pontos de latitude/longitude que você pode passar direto para uma polilinha — por padrão, a cada cinco graus de latitude, o que pode ser ajustado com latitude_step. As curvas param onde o corpo se torna circumpolar, e isso é real, não falta de dados: acima de certa latitude, o corpo nunca cruza o horizonte, então ali não há linha ascendente para desenhar. O ponto de corte varia de planeta para planeta porque depende da declinação. latitude e longitude são opcionais apenas neste endpoint. Uma linha ACG é fixada pelo MOMENTO do nascimento — as fórmulas usam ascensão reta, declinação e tempo sideral, e nada mais —, então exigir um local de nascimento daria a entender que ele muda a resposta, quando não muda. Use /api/astro/astrocartography/relocate/ quando quiser as linhas próximas de um local específico.
https://api.occultapi.com/api/astro/astrocartography/lines/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/jsonCampos da requisição
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| date_time | string (date-time) | obrigatório | 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. |
| timezone_as_float | number (double) | obrigatório | 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 |
| bodies | array | opcional | Padrão: todos os doze. Restrinja para manter as respostas pequenas. |
| close_curves | boolean | opcional | Adiciona pontos que levam cada curva AC/DC até onde ela termina: a latitude em que o corpo deixa de nascer e de se pôr, onde as curvas AC e DC se encontram sobre a linha MC ou IC dele. Ative ao desenhar; desativado (o padrão), ficam só as amostras simples, em intervalos regulares. |
| keys | array | opcional | Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas. |
| latitude | number (double) | opcional | 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. |
| latitude_step | number (double) | opcional | Graus de latitude entre os pontos das curvas AC/DC. min 1 · max 15 |
| longitude | number (double) | opcional | 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. |
| node | string | opcional | Qual nodo lunar é o `north_node`: true (o padrão) ou mean. truemean |
| projection | string | opcional | mundo (o padrão): posições verdadeiras, com a latitude incluída. zodiac: posições projetadas na eclíptica, correspondendo 1:1 a um mapa relocalizado. mundozodiac |
Exemplo de requisição
Exemplo ainda não verificado
Os nomes e tipos de campo abaixo vêm da definição da API e estão corretos. Mas este corpo específico não deu sucesso na última vez que o rodamos — talvez falte um valor que não conseguimos deduzir. Use-o como ponto de partida, não como um comando pronto.
curl -X POST https://api.occultapi.com/api/astro/astrocartography/lines/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01 06:00:00","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"node":"true","projection":"mundo"}'Resposta
Ainda não temos um exemplo de resposta verificado para este endpoint. O formato da requisição acima é gerado a partir da definição da API e está correto; só publicamos exemplos de resposta depois de confirmá-los numa chamada real.
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.