POST/api/astro/human-design/chart/1 crédito

Bodygraph do Human Design

O bodygraph completo do Human Design, calculado a partir das efemérides. O Human Design lê as longitudes planetárias duas vezes, sobre uma roda fixa de 64 portais derivada do I Ching. A camada da personalidade é o momento do nascimento. A camada do design é o momento, cerca de três meses antes, em que o Sol estava exatamente 88 graus atrás na eclíptica — não 88 dias: a órbita da Terra é excêntrica, então o intervalo vai de cerca de 86 a 92 dias, conforme a época do ano, e este endpoint calcula o momento exato. Retorna treze ativações para cada camada (os dez planetas mais a Terra, e os dois nodos lunares), cada uma com portal, linha, nome do portal e centro. A partir da união desses portais, informa cada um dos 36 canais que estão completos, indicando que camada forneceu cada extremidade; os nove centros, marcados como definidos ou abertos; e o tipo, a estratégia, a autoridade interna, o perfil, a definição e a cruz de encarnação que decorrem disso. Cada valor sai de uma consulta ou de um percurso em grafo, então o mesmo momento de nascimento sempre retorna o mesmo mapa. O que fica de fora, de propósito, é o significado de tudo isso — interpretação é trabalho de autor, não algo que efemérides possam produzir. latitude e longitude são opcionais. Um bodygraph não usa casas nem ângulos, então o local de nascimento nunca entra no cálculo: duas pessoas nascidas no mesmo instante, em qualquer lugar da Terra, têm mapas idênticos. Implementações que exigem um local de nascimento dão a entender o contrário.

https://api.occultapi.com/api/astro/human-design/chart/

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
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
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.
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_type	string	opcional	Qual nodo lunar determina as ativações dos nodos: "mean" (padrão) ou "true", que é o usado pelo MMI do Jovian Archive. Não diferencia maiúsculas de minúsculas; vazio ou null equivale ao padrão.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/human-design/chart/ \
  -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}'

Resposta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"birth_datetime_utc\": \"2026-09-01T00:30:00.000Z\", \"design_datetime_utc\": \"2026-06-01T01:52:50.642Z\", \"design_solar_arc_degrees\": 88.0, \"days_between\": 91.942469, \"design\": [{\"body\": \"sun\", \"longitude\": 70.613407, \"gate\": 16, \"line\": 6, \"gate_name\": \"Skills\", \"centre\": \"throat\", \"percent_through_gate\": 86.4606}, {\"body\": \"earth\", \"longitude\": 250.613407, \"gate\": 9, \"line\": 6, \"gate_name\": \"Focus\", \"centre\": \"sacral\", \"percent_through_gate\": 86.4606}, {\"body\": \"north_node\", \"longitude\": 334.170857, \"gate\": 55, \"line\": 5, \"gate_name\": \"Spirit\", \"centre\": \"solar_plexus\", \"percent_through_gate\": 71.9264}, {\"body\": \"south_node\", \"longitude\": 154.170857, \"gate\": 59, \"line\": 5, \"gate_name\": \"Sexuality\", \"centre\": \"sacral\", \"percent_through_gate\": 71.9264}, {\"body\": \"moon\", \"longitude\": 258.409187, \"gate\": 26, \"line\": 2, \"gate_name\": \"The Egoist\", \"centre\": \"will\", \"percent_through_gate\": 25.0522}, {\"body\": \"mercury\", \"longitude\": 89.285947, \"gate\": 15, \"line\": 2, \"gate_name\": \"Extremes\", \"centre\": \"identity\", \"percent_through_gate\": 18.4168}, {\"body\": \"venus\", \"longitude\": 105.487784, \"gate\": 53, \"line\": 1, \"gate_name\": \"Beginnings\", \"centre\": \"root\", \"percent_through_gate\": 6.4495}, {\"body\": \"mars\", \"longitude\": 39.817815, \"gate\": 24, \"line\": 3, \"gate_name\": \"Rationalizing\", \"centre\": \"ajna\", \"percent_through_gate\": 38.9834}, {\"body\": \"jupiter\", \"longitude\": 114.082386, \"gate\": 62, \"line\": 4, \"gate_name\": \"Detail\", \"centre\": \"throat\", \"percent_through_gate\": 59.2424}, {\"body\": \"saturn\", \"longitude\": 12.251159, \"gate\": 21, \"line\": 3, \"gate_name\": \"The Hunter\", \"centre\": \"will\", \"percent_through_gate\": 48.9095}, {\"body\": \"uranus\", \"longitude\": 62.068489, \"gate\": 20, \"line\": 3, \"gate_name\": \"The Now\", \"centre\": \"throat\", \"percent_through_gate\": 34.5509}, {\"body\": \"neptune\", \"longitude\": 4.062081, \"gate\": 17, \"line\": 1, \"gate_name\": \"Opinions\", \"centre\": \"ajna\", \"percent_through_gate\": 3.3259}, {\"body\": \"pluto\", \"longitude\": 305.363473, \"gate\": 41, \"line\": 4, \"gate_name\": \"Contraction\", \"centre\": \"root\", \"percent_through_gate\": 59.7951}], \"personality\": [{\"body\": \"sun\", \"longitude\": 158.613407, \"gate\": 40, \"line\": 4, \"gate_name\": \"Aloneness\", \"centre\": \"will\", \"percent_through_gate\": 50.905}, {\"body\": \"earth\", \"longitude\": 338.613407, \"gate\": 37, \"line\": 4, \"gate_name\": \"Friendship\", \"centre\": \"solar_plexus\", \"percent_through_gate\": 50.905}, {\"body\": \"north_node\", \"longitude\": 329.30287, \"gate\": 30, \"line\": 6, \"gate_name\": \"Recognition of Feelings\", \"centre\": \"solar_plexus\", \"percent_through_gate\": 85.3843}, {\"body\": \"south_node\", \"longitude\": 149.30287, \"gate\": 29, \"line\": 6, \"gate_name\": \"Perseverance\", \"centre\": \"sacral\", \"percent_through_gate\": 85.3843}, {\"body\": \"moon\", \"longitude\": 25.710149, \"gate\": 42, \"line\": 6, \"gate_name\": \"Growth\", \"centre\": \"sacral\", \"percent_through_gate\": 88.1804}, {\"body\": \"mercury\", \"longitude\": 162.740574, \"gate\": 64, \"line\": 2, \"gate_name\": \"Confusion\", \"centre\": \"head\", \"percent_through_gate\": 24.2769}, {\"body\": \"venus\", \"longitude\": 203.188417, \"gate\": 32, \"line\": 3, \"gate_name\": \"Continuity\", \"centre\": \"spleen\", \"percent_through_gate\": 43.3496}, {\"body\": \"mars\", \"longitude\": 103.406817, \"gate\": 39, \"line\": 5, \"gate_name\": \"Provocation\", \"centre\": \"root\", \"percent_through_gate\": 69.4545}, {\"body\": \"jupiter\", \"longitude\": 133.704048, \"gate\": 7, \"line\": 1, \"gate_name\": \"The Role of the Self\", \"centre\": \"identity\", \"percent_through_gate\": 8.072}, {\"body\": \"saturn\", \"longitude\": 13.679498, \"gate\": 21, \"line\": 5, \"gate_name\": \"The Hunter\", \"centre\": \"will\", \"percent_through_gate\": 74.3022}, {\"body\": \"uranus\", \"longitude\": 65.655978, \"gate\": 20, \"line\": 6, \"gate_name\": \"The Now\", \"centre\": \"throat\", \"percent_through_gate\": 98.3285}, {\"body\": \"neptune\", \"longitude\": 3.665567, \"gate\": 25, \"line\": 6, \"gate_name\": \"The Spirit of the Self\", \"centre\": \"identity\", \"percent_through_gate\": 96.2767}, {\"body\": \"pluto\", \"longitude\": 303.511485, \"gate\": 41, \"line\": 2, \"gate_name\": \"Contraction\", \"centre\": \"ro"
}

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.