Назад к документации

Матч по рождению

Матч по рождению

POST/api/v2/vedic/match

Рассчитайте совместимость V2 Аштакута на основе двух полных карт рождения, включая разрешение положения Луны и проверки дош.

Аутентификация: отправьте x-api-key.

Полный URL-адрес

https://api.freeastroapi.com/api/v2/vedic/match
Безопасные повторы с Idempotency-Key

Аутентифицированные платные astrology POST-запросы принимают необязательный заголовок Idempotency-Key: <уникальный ключ операции, созданный клиентом>. Повторно используйте тот же ключ только при повторе точно того же method, path, query string и JSON body после timeout или сетевой ошибки.

Завершенный повтор возвращает первый ответ с Idempotency-Replayed: true, не запускает расчет заново и не расходует дополнительную квоту. Ключи хранятся примерно 24 часа.

Повторное использование ключа с измененным запросом возвращает 409 idempotency_key_reused. Дубликат, пока первый запрос еще выполняется, возвращает 409 request_in_progress с Retry-After.

Что он возвращает

Контракт совместимости birth-data-only: уточненные детали Луны человека, оценки Аштакута кута с доказательствами, контекст доши Мглик/Нади/Бхакут, сводная оценка и метаданные.

Пример запроса

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/match" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "person1": {
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 10,
    "minute": 30,
    "city": "New Delhi",
    "lat": 28.6139,
    "lng": 77.209,
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean"
  },
  "person2": {
    "year": 1993,
    "month": 8,
    "day": 21,
    "hour": 14,
    "minute": 0,
    "city": "Mumbai",
    "lat": 19.076,
    "lng": 72.8777,
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean"
  }
}'

Параметры запроса

Передайте city либо оба поля — lat и lng. Для стабильных результатов в production рекомендуется использовать координаты.

Поле
person1
Тип
object
Обязательно
Да
Описание
Сведения о рождении человека 1 с использованием тех же базовых ведических полей рождения.
Поле
person2
Тип
object
Обязательно
Да
Описание
Сведения о рождении человека 2 с использованием тех же базовых ведических полей рождения.
Поле
person1.year
Тип
integer
Обязательно
Да
Описание
Год рождения человека 1.
Поле
person1.month
Тип
integer
Обязательно
Да
Описание
Месяц рождения человека 1.
Поле
person1.day
Тип
integer
Обязательно
Да
Описание
День рождения человека 1.
Поле
person1.hour
Тип
integer
Обязательно
Да
Описание
Час рождения человека 1.
Поле
person1.minute
Тип
integer
Обязательно
Да
Описание
Минута рождения человека 1.
Поле
person1.lat / person1.lng
Тип
float
Обязательно
Нет
Описание
Координаты человека 1. Рекомендуется при наличии.
Поле
person2.year
Тип
integer
Обязательно
Да
Описание
Год рождения человека 2.
Поле
person2.month
Тип
integer
Обязательно
Да
Описание
Месяц рождения человека 2.
Поле
person2.day
Тип
integer
Обязательно
Да
Описание
День рождения человека 2.
Поле
person2.hour
Тип
integer
Обязательно
Да
Описание
Час рождения человека 2.
Поле
person2.minute
Тип
integer
Обязательно
Да
Описание
Минута рождения человека 2.
Поле
person2.lat / person2.lng
Тип
float
Обязательно
Нет
Описание
Координаты человека 2. Рекомендуется при наличии.

Форма ответа

Поле
persons
Тип
array
Обязательно
Не применимо
Описание
Разрешенные данные людей: Moon sign и детали Nakshatra.
Поле
ashtakoota
Тип
object
Обязательно
Не применимо
Описание
Оценка восемь-koota, процент, рекомендации и доказательства для каждого koota.
Поле
doshas
Тип
object
Обязательно
Не применимо
Описание
Детали дош Manglik, Nadi и Bhakoot.
Поле
summary
Тип
object
Обязательно
Не применимо
Описание
Общий балл, traditional-порог, флаг прохождения и флаги риска.
Поле
metadata
Тип
object
Обязательно
Не применимо
Описание
Версия endpoint, ruleset, расчетная база и input-режимы.

Пример реального запроса

Этот запрос был получен из конечной точки реального производства и представляет собой ту же полезную нагрузку, которая используется во вкладках кода.

{
  "person1": {
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 10,
    "minute": 30,
    "city": "New Delhi",
    "lat": 28.6139,
    "lng": 77.209,
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean"
  },
  "person2": {
    "year": 1993,
    "month": 8,
    "day": 21,
    "hour": 14,
    "minute": 0,
    "city": "Mumbai",
    "lat": 19.076,
    "lng": 72.8777,
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean"
  }
}

Пример реального ответа

Это реальный производственный ответ на пример полезной нагрузки. Большие массивы намеренно отображаются так, как их возвращает API.

V2
{
  "persons": [
    {
      "label": "Person 1",
      "input_mode": "birth_chart",
      "moon_sign": {
        "id": 9,
        "name": "Sagittarius",
        "degree": 29.8424
      },
      "moon_nakshatra": {
        "id": 21,
        "name": "Uttara Ashadha",
        "pada": 1,
        "lord": "Sun"
      }
    },
    {
      "label": "Person 2",
      "input_mode": "birth_chart",
      "moon_sign": {
        "id": 6,
        "name": "Virgo",
        "degree": 24.1171
      },
      "moon_nakshatra": {
        "id": 14,
        "name": "Chitra",
        "pada": 1,
        "lord": "Mars"
      }
    }
  ],
  "ashtakoota": {
    "score": 21,
    "max_score": 36,
    "percentage": 58.3,
    "recommendation": "Average Match",
    "kootas": [
      {
        "id": "varna",
        "name": "Varna",
        "score": 1,
        "max_score": 1,
        "status": "strong",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Kshatriya; Person 2: Vaishya."
          }
        ]
      },
      {
        "id": "vashya",
        "name": "Vashya",
        "score": 1,
        "max_score": 2,
        "status": "moderate",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Quadruped; Person 2: Human."
          }
        ]
      },
      {
        "id": "tara",
        "name": "Tara",
        "score": 1.5,
        "max_score": 3,
        "status": "moderate",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Directional Tara scores are 0.0 and 1.5."
          }
        ]
      },
      {
        "id": "yoni",
        "name": "Yoni",
        "score": 2,
        "max_score": 4,
        "status": "moderate",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Mongoose; Person 2: Tiger."
          }
        ]
      },
      {
        "id": "graha_maitri",
        "name": "Graha Maitri",
        "score": 0.5,
        "max_score": 5,
        "status": "weak",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Moon sign lords are Jupiter and Mercury; relations are enemy/neutral."
          }
        ]
      },
      {
        "id": "gana",
        "name": "Gana",
        "score": 0,
        "max_score": 6,
        "status": "dosha",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Manushya; Person 2: Rakshasa."
          }
        ]
      },
      {
        "id": "bhakoot",
        "name": "Bhakoot",
        "score": 7,
        "max_score": 7,
        "status": "strong",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Moon signs are in 10/4 relation."
          }
        ]
      },
      {
        "id": "nadi",
        "name": "Nadi",
        "score": 8,
        "max_score": 8,
        "status": "strong",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Antya; Person 2: Madhya."
          }
        ]
      }
    ]
  },
  "doshas": {
    "manglik": {
      "person1": {
        "available": true,
        "active": true,
        "severity": "Low Mangal Dosha",
        "severity_score": 1,
        "reference_frames": [
          {
            "frame": "Lagna",
            "house": 8
          }
        ],
        "cancellations": [
          {
            "kind": "jupiter_aspect",
            "message": "Jupiter aspects Mars by Vedic graha drishti."
          }
        ],
        "message": "Low Mangal Dosha."
      },
      "person2": {
        "available": true,
        "active": true,
        "severity": "Low Mangal Dosha",
        "severity_score": 1,
        "reference_frames": [
          {
            "frame": "Moon",
            "house": 1
          }
        ],
        "cancellations": [
          {
            "kind": "jupiter_conjunction",
            "message": "Jupiter is conjoined Mars by sign."
          }
        ],
        "message": "Low Mangal Dosha."
      },
      "compatibility": {
        "available": true,
        "status": "balanced",
        "difference": 0,
        "message": "Mangal Dosha levels are balanced between both charts."
      }
    },
    "nadi": {
      "active": false,
      "score": 8,
      "max_score": 8,
      "message": "Nadi score is 8 out of 8."
    },
    "bhakoot": {
      "active": false,
      "score": 7,
      "max_score": 7,
      "message": "Bhakoot score is 7 out of 7."
    }
  },
  "summary": {
    "total_score": 21,
    "max_score": 36,
    "minimum_traditional_threshold": 18,
    "passes_minimum_threshold": true,
    "risk_flags": [
      "manglik_requires_review"
    ]
  },
  "metadata": {
    "endpoint_version": "v2",
    "ruleset_version": "astrosage_ashtakoota_v1",
    "calculation_basis": "moon_nakshatra_moon_rashi_ashtakoota",
    "person1_input_mode": "birth_chart",
    "person2_input_mode": "birth_chart"
  }
}

Связанные документы