/api/astro/rashifal/yearly/1 кредитРашифал на цей рік
Тлумачення на цей рік для одного раші з усіма сферами життя. КОЖНА СФЕРА ЖИТТЯ ПОВЕРТАЄТЬСЯ ПРИ КОЖНОМУ ВИКЛИКУ: загальна, кар’єра й бізнес, кохання й стосунки, гроші й фінанси, здоров’я, освіта й навчання, сім’я, подорожі, бізнес і професіонали. Цим ендпоінт відрізняється від /api/astro/rashifal/, який повертає змінну вибірку з трьох-чотирьох сфер залежно від дати, тож сторінку для однієї фіксованої сфери на ньому не побудувати. Надішліть `aspect`, щоб отримати лише одну. Тлумачення детерміновані: той самий знак, період, сфера й дата завжди дають ті самі слова, тож сторінку можна кешувати, і вона не суперечитиме собі після оновлення. `rashi` і `aspect` — без урахування регістру. `date` за замовчуванням — сьогодні; для «завтра» та «вчора» зсув застосовується до надісланої дати. Це тлумачення за знаком, прив’язане до транзиту Місяця, а не натальна карта: воно не потребує часу чи місця народження і не є гороскопом. Річний прогноз також повертає поквартальний прогноз, планетарні рухи року, щасливі елементи та засоби корекції.
https://api.occultapi.com/api/astro/rashifal/yearly/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| rashi | string | обов’язковий | Західна назва знака. Без урахування регістру: приймаються Aries, aries і ARIES. ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces |
| aspect | string | необов’язковий | Повернути лише цю сферу; регістр будь-який. Якщо не вказано, повертаються всі десять. * `general` - general * `career_business` - career_business * `love_relationships` - love_relationships * `money_finances` - money_finances * `health` - health * `education_student` - education_student * `family` - family * `travel` - travel * `business` - business * `professionals` - professionals |
| date | string (date) | необов’язковий | День, для якого складається тлумачення. За замовчуванням — сьогодні. Для `tomorrow` і `yesterday` зсув застосовується до цієї дати: якщо надіслати 2026-09-16 на /tomorrow/, повернеться тлумачення на 2026-09-17. |
Приклад запиту
Цей приклад ще не перевірено
Назви й типи полів нижче взято з опису API, тож вони точні. Але саме це тіло запиту під час останнього запуску не повернуло успішної відповіді: можливо, йому бракує значення, яке ми не можемо вгадати. Вважайте його заготовкою, а не готовою командою.
curl -X POST https://api.occultapi.com/api/astro/rashifal/yearly/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"rashi":"aries","date":"2026-09-01"}'Відповідь
Перевіреного прикладу відповіді для цього ендпоінта поки немає. Структуру запиту вище згенеровано з опису API, і вона точна. Приклади відповідей ми публікуємо лише тоді, коли перевіримо їх на реальному виклику.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.