/api/astro/horoscope-match/1 кредитСумісність для шлюбу
Повна перевірка шлюбної сумісності за ашта-кутою — за даними народження двох людей, а не за двома номерами накшатр. Вкажіть дату, час і місце народження кожного з партнерів, і ендпоінт сам визначить місячний знак, накшатру й паду, оцінить вісім кут (максимум 36 балів), перевірить дві блокувальні доші й поверне висновок. Відповідь складається з чотирьох частин. `boy` і `girl` — зведення по кожній карті: місячний знак, назва й номер накшатри, пада, довгота Місяця та знак асцендента. `gunas` — список із восьми об’єктів, по одному на куту: `key` і `label`, `max_points` і `obtained_points`, порівнювані значення `boy_value` і `girl_value` (варна, тварина йоні, гана тощо), `area_of_life` — сфера життя, за яку відповідає кута, і `description` — простий опис англійською. Цього досить, щоб показати таблицю результатів, не пишучи жодного тексту. Далі йдуть `total_score`, `max_score` зі значенням 36 і `minimum_recommended_score` зі значенням 18. Нарешті — `doshas`, `verdict` і `verdict_reason`. Нуль балів за Наді означає Наді-дошу, а нуль за Бхакут — Бхакут-дошу, і будь-яка з них дає висновок 'Union is NOT Recommended' незалежно від суми. В інших випадках 28 і більше — 'Union is Excellent', 18 і більше — 'Union is Good', а нижче — шлюб не рекомендовано. Кожен об’єкт партнера приймає `date_time`, `latitude`, `longitude` і `timezone_as_float`, а також необов’язкові мітки `name` і `city`, які повертаються без змін. Завжди використовується аянамша Lahiri; поле `ayanamsa` приймається, але ні на що не впливає.
https://api.occultapi.com/api/astro/horoscope-match/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| boy | object | обов’язковий | ОБ’ЄКТ із фіксованими ключами: name (рядок, необов’язкове, довільна мітка), date_time (обов’язкове, ISO-8601), latitude (обов’язкове, -89.9..89.9), longitude (обов’язкове, -180..180), timezone_as_float (обов’язкове, -12.0..14.0), city (рядок, необов’язкове, довільна мітка). `name` і `city` не перевіряються й не впливають на розрахунок. |
| girl | object | обов’язковий | ОБ’ЄКТ — та сама структура й правила, що й для `boy`. |
| ayanamsa | string | необов’язковий |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/horoscope-match/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"boy":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5},"girl":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}}'Відповідь
{
"data": {
"boy": {
"name": "",
"city": "",
"moon_sign": "Aries",
"nakshatra": "Ashwini",
"nakshatra_number": 1,
"paadha_number": 1,
"moon_longitude": 1.478,
"ascendant_sign": "Leo"
},
"girl": {
"name": "",
"city": "",
"moon_sign": "Aries",
"nakshatra": "Ashwini",
"nakshatra_number": 1,
"paadha_number": 1,
"moon_longitude": 1.478,
"ascendant_sign": "Leo"
},
"gunas": [
{
"key": "varna",
"label": "Varna",
"max_points": 1,
"obtained_points": 1,
"boy_value": "Brahmin",
"girl_value": "Brahmin",
"area_of_life": "Obedience",
"description": "Varna Kuta is assigned 1 point. It represents mutual love, comfort and obedience - the spiritual compatibility between the couple."
},
{
"key": "vashya",
"label": "Vashya",
"max_points": 2,
"obtained_points": 2,
"boy_value": "Chatushpada",
"girl_value": "Chatushpada",
"area_of_life": "Mutual Control",
"description": "Vashya Kuta is assigned 2 points. It represents mutual control or dominance, along with friendship and amenability between the couple."
},
{
"key": "tara",
"label": "Tara",
"max_points": 3,
"obtained_points": 3,
"boy_value": "Sampat",
"girl_value": "Sampat",
"area_of_life": "Luck",
"description": "Tara Kuta is assigned 3 points. It represents luck, auspiciousness and the transmission of mutual well-being between the couple."
},
{
"key": "yoni",
"label": "Yoni",
"max_points": 4,
"obtained_points": 4,
"boy_value": "Horse",
"girl_value": "Horse",
"area_of_life": "Sexual Aspects",
"description": "Yoni Kuta is assigned 4 points. It represents sexual aspects, including compatibility of intimate temperament."
},
{
"key": "maitri",
"label": "Maitri",
"max_points": 5,
"obtained_points": 5,
"boy_value": "Mars",
"girl_value": "Mars",
"area_of_life": "Affection",
"description": "Maitri (Graha Maitri) Kuta is assigned 5 points. It represents psychological disposition, mental qualities and affection between the couple."
},
{
"key": "gana",
"label": "Gana",
"max_points": 6,
"obtained_points": 6,
"boy_value": "Deva",
"girl_value": "Deva",
"area_of_life": "Nature",
"description": "Gana Kuta is assigned 6 points. It represents nature, temperament, longevity, wealth and love."
},
{
"key": "bhakoot",
"label": "Bhakoot",
"max_points": 7,
"obtained_points": 7,
"boy_value": "Mesha",
"girl_value": "Mesha",
"area_of_life": "Love",
"description": "Bhakoot (Rashi) Kuta is assigned 7 points. It represents children, wealth, comfort, good luck and growth of the family."
},
{
"key": "nadi",
"label": "Nadi",
"max_points": 8,
"obtained_points": 0,
"boy_value": "Aadi",
"girl_value": "Aadi",
"area_of_life": "Health",
"description": "Nadi Kuta is assigned 8 points, the most important of all. It represents temperament, health, and genetic compatibility for progeny."
}
],
"total_score": 28,
"max_score": 36,
"minimum_recommended_score": 18,
"doshas": [
"Nadi Dosha"
],
"verdict": "Union is NOT Recommended",
"verdict_reason": "due to Nadi Dosha"
},
"message": "successful",
"is_error": false
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.