/api/astro/pdf/yearbook/25 créditosAnuário em PDF
Os próximos doze meses como um PDF pronto, divididos por período de dasha. O corpo da resposta É o PDF (`application/pdf`) — uma chamada, nada armazenado. Enquanto /api/astro/pdf/horoscope/ descreve uma natividade, este descreve um ano dela. O horóscopo é o mesmo documento quer você o gere hoje, quer daqui a dez anos; este está ancorado em uma data e fica desatualizado — gere-o de novo no ano que vem e todas as páginas serão diferentes. O ANO NÃO É DIVIDIDO EM MESES DO CALENDÁRIO. Ele é dividido pelo pratyantardasha do Vimshottari — o terceiro nível da árvore de dashas —, então cada seção começa e termina em uma data definida por este mapa. Um período pode, portanto, durar três semanas ou dois meses, e o primeiro e o último geralmente ultrapassam a janela de doze meses, porque um período é impresso por inteiro ou não é impresso. Cada período é lido nas áreas de finanças, carreira, vida familiar, amor e vida conjugal, e saúde, com o que fazer, o que evitar e os remédios tradicionais para o graha daquele período. Se um período é favorável ou exigente depende da dignidade, da casa e da natureza funcional do graha regente NESTE MAPA, e os fundamentos são impressos ao lado do veredito — assim, duas pessoas no mesmo período de Vênus não recebem a mesma página. DETERMINÍSTICO. Cada parágrafo vem de uma tabela, não é gerado: os mesmos dados de nascimento e o mesmo `start_date` produzem um livro idêntico byte a byte, e é isso que permite responder a chamados de suporte. O padrão de `start_date` é hoje. Passe o próximo aniversário do nativo para obter um livro de aniversário a aniversário em vez de um livro com janela móvel. Recebe os mesmos dados de nascimento e o mesmo bloco opcional `branding` do relatório de horóscopo. Vale a pena ler dois cabeçalhos de resposta: `X-Report-Periods` informa em quantos períodos de dasha o ano foi dividido, para que você distinga um livro completo de um incompleto sem abri-lo, e `X-Report-Sections-Failed` conta qualquer cálculo que não pôde ser concluído.
https://api.occultapi.com/api/astro/pdf/yearbook/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 |
|---|---|---|---|
| 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 |
| ayanamsa | string | opcional | |
| branding | object | opcional | Dados do revendedor impressos na capa, no cabeçalho e no rodapé. |
| 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. |
| day | integer | opcional | Dia do mês como número, de 1 a 31. min 1 · max 31 |
| gender | string | opcional | |
| hour | integer | opcional | Hora do nascimento no formato de 24 horas, 0-23. Hora local do local de nascimento. min 0 · max 23 |
| minute | integer | opcional | min 0 · max 59 |
| month | integer | opcional | Mês de nascimento como número, 1-12. Janeiro é 1. min 1 · max 12 |
| name | string | opcional | |
| place | string | opcional | |
| start_date | string (date) | opcional | Primeiro dia dos doze meses a cobrir, YYYY-MM-DD. Padrão: hoje. Passe o próximo aniversário do nativo para obter um livro de aniversário a aniversário em vez de um livro com janela móvel. |
| 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 |
| year | integer | opcional | Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2200 |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/pdf/yearbook/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Ajeet Kanojia","gender":"male","date_time":"1985-02-23T05:45:00+05:30","latitude":20.8833,"longitude":76.2,"timezone_as_float":5.5,"place":"Malkapur, Maharashtra, India","start_date":"2026-01-01","branding":{"company_name":"Acme Astrology","company_info":"Vedic reports since 2011.","company_email":"hello@acme.example","domain_url":"https://acme.example","footer_link":"acme.example"}}'Resposta
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.