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

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

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

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 and lng. Координаты рекомендуются для стабильных результатов производства.

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

Форма ответа

Field
persons
Type
array
Required
n/a
Description
Разрешенные данные людей: Moon sign и детали Nakshatra.
Field
ashtakoota
Type
object
Required
n/a
Description
Оценка восемь-koota, процент, рекомендации и доказательства для каждого koota.
Field
doshas
Type
object
Required
n/a
Description
Детали дош Manglik, Nadi и Bhakoot.
Field
summary
Type
object
Required
n/a
Description
Общий балл, traditional-порог, флаг прохождения и флаги риска.
Field
metadata
Type
object
Required
n/a
Description
Версия 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"
  }
}

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

Совместимость вручнуюОбнаружение йоги