/api/astro/pdf/horoscope/25 кредитівPDF-звіт гороскопа
Повний ведичний гороскоп у вигляді готового PDF за один виклик. Тіло відповіді І Є PDF (`application/pdf`) — ні другого запиту, ні файлу на сервері. Понад сорок сторінок: дані народження й панчанг, положення планет із володарями накшатр, карта лагни в північноіндійському та південноіндійському стилях, карта Місяця, дванадцять дробових карт, куспіди домів, дружба планет, розміщення KP, сарваштакаварга плюс сторінка бхіннаштакаварги для кожної грахи, три системи даш із поточним періодом, розгорнутим на підперіоди, висновки щодо Кала Сарпи та манглік, повна часова шкала Саде Саті з фазами Ардха Кантака та Аштама Шані, нумерологія, рекомендації щодо каменів, рудракші й мантр, а також тлумачення для кожної з дев’яти грах. МИ НІЧОГО НЕ ЗБЕРІГАЄМО. API звітів зазвичай записують файл у бакет і повертають посилання, а отже натальна карта — ім’я, час народження, набір прогнозів — лежить за публічним URL, доки існує об’єкт. Ми ж повертаємо байти вам. На нашому боці нічого не записується, і немає посилання, яке хтось інший міг би знайти. Якщо вам потрібна копія на сервері, збережіть ці байти самі, із власним терміном зберігання та власними правилами доступу. ПІД ВАШИМ БРЕНДОМ (WHITE LABEL). Усе в `branding` необов’язкове й з’являється на обкладинці, у верхньому та нижньому колонтитулах, тож ваш клієнт бачить вашу назву. Нашої назви в документі немає ніде. МОМЕНТ НАРОДЖЕННЯ. Надішліть або `date_time` у форматі ISO 8601, або окремі поля `day`/`month`/`year`/`hour`/`minute` разом із `timezone_as_float`. Якщо надіслати обидва варіанти, запит буде відхилено, а не вирішено на вашу користь: коли вони розходяться, безпечно вибрати один неможливо, а результатом стала б упевнено неправильна карта. Кожне значення обчислюють ті самі ендпоінти, які надає цей API: положення на сторінці 3 — саме те, що повертає /api/astro/planet-positions/. Розділи формуються незалежно: якщо якийсь розрахунок для карти не визначений, на відповідній сторінці так і написано, а решта звіту все одно формується. Заголовок відповіді `X-Report-Sections-Failed` показує, скільки таких розділів, тож повний звіт можна відрізнити від неповного, не відкриваючи його. Зазвичай увесь процес займає менше двох секунд.
https://api.occultapi.com/api/astro/pdf/horoscope/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -90 · max 90 |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| ayanamsa | string | необов’язковий | |
| branding | object | необов’язковий | Дані реселера, що друкуються на обкладинці, у верхньому та нижньому колонтитулах. |
| chart_style | string | необов’язковий | У якому стилі малювати натальну карту. За замовчуванням включено обидва. northsouthboth |
| date_time | string (date-time) | необов’язковий | Момент, для якого виконується розрахунок, у форматі ISO 8601. ЗАВЖДИ вказуйте зміщення або Z у кінці: значення без часового поясу читається як Asia/Kolkata (UTC+05:30), а не UTC, і може повернути результат за попередній день із кодом 200. '2026-09-01T06:00:00Z' і '2026-09-01 06:00:00' — різні моменти, і відповіді для них різні. |
| day | integer | необов’язковий | День місяця числом, 1-31. min 1 · max 31 |
| gender | string | необов’язковий | |
| hour | integer | необов’язковий | Година народження у 24-годинному форматі, 0-23. Місцевий час у місці народження. min 0 · max 23 |
| minute | integer | необов’язковий | min 0 · max 59 |
| month | integer | необов’язковий | Місяць народження числом від 1 до 12; січень — 1. min 1 · max 12 |
| name | string | необов’язковий | |
| place | string | необов’язковий | |
| timezone_as_float | number (double) | необов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14 |
| year | integer | необов’язковий | Рік народження числом, напр. 1990. Чотири цифри. min 1800 · max 2200 |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/pdf/horoscope/ \
-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","chart_style":"both","branding":{"company_name":"Acme Astrology","company_info":"Vedic reports since 2011.","company_email":"hello@acme.example","company_mobile":"+91 90000 00000","domain_url":"https://acme.example","footer_link":"acme.example"}}'Відповідь
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.