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

Совместимость

Совместимость

POST/api/v2/vedic/compatibility

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

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

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

https://api.freeastroapi.com/api/v2/vedic/compatibility
Безопасные повторы с 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.

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

Полезная нагрузка совместимости с разрешенными деталями Луны, оценками и доказательствами Ashtakoota koota-by-koota, проверками дош, сводными оценками и метаданными input-mode. Используйте /match, если доступны обе полные данные о рождении.

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

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/compatibility" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "person1_moon": {
    "label": "Person 1",
    "moon_nakshatra": 22,
    "moon_sign": 10,
    "moon_degree": 14.2,
    "moon_pada": 2
  },
  "person2_moon": {
    "label": "Person 2",
    "moon_nakshatra": 13,
    "moon_sign": 6,
    "moon_degree": 8.5,
    "moon_pada": 3
  }
}'

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

Предоставьте либо city или оба lat and lng. Координаты рекомендуются для стабильных результатов производства.

Field
person1
Type
object
Required
No
Description
Дополнительные сведения о рождении человека 1. Используйте с person2 для режима карты рождения.
Field
person2
Type
object
Required
No
Description
Необязательные данные о рождении Лица 2. Используйте с person1 для режима карты рождения.
Field
person1_moon
Type
object
Required
No
Description
Структурированные ручные данные Луны для человека 1.
Field
person2_moon
Type
object
Required
No
Description
Структурированные ручные данные Луны для человека 2.
Field
person1_moon.moon_nakshatra
Type
integer
Required
No
Description
Луна Nakshatra ID, 1-27.
Field
person1_moon.moon_sign
Type
integer
Required
No
Description
Лунный знак ID, 1-12.
Field
person1_moon.moon_degree
Type
float
Required
No
Description
Градус Луны внутри знака, 0 <= degree < 30.
Field
person1_moon.moon_pada
Type
integer
Required
No
Description
Nakshatra пада, 1-4.
Field
person2_moon.moon_nakshatra
Type
integer
Required
No
Description
Луна Nakshatra ID, 1-27.
Field
person2_moon.moon_sign
Type
integer
Required
No
Description
Лунный знак ID, 1-12.
Field
person2_moon.moon_degree
Type
float
Required
No
Description
Градус Луны внутри знака, 0 <= degree < 30.
Field
person2_moon.moon_pada
Type
integer
Required
No
Description
Nakshatra пада, 1-4.
Field
person1_moon_nakshatra / person2_moon_nakshatra
Type
integer
Required
No
Description
Устаревшие поля Луны с плоским руководством по-прежнему принимаются для совместимости.
Field
person1_moon_sign / person2_moon_sign
Type
integer
Required
No
Description
Устаревшие поля знака плоской Луны по-прежнему принимаются для совместимости.

Форма ответа

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_moon": {
    "label": "Person 1",
    "moon_nakshatra": 22,
    "moon_sign": 10,
    "moon_degree": 14.2,
    "moon_pada": 2
  },
  "person2_moon": {
    "label": "Person 2",
    "moon_nakshatra": 13,
    "moon_sign": 6,
    "moon_degree": 8.5,
    "moon_pada": 3
  }
}

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

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

V2
{
  "persons": [
    {
      "label": "Person 1",
      "input_mode": "manual",
      "moon_sign": {
        "id": 10,
        "name": "Capricorn",
        "degree": 14.2
      },
      "moon_nakshatra": {
        "id": 22,
        "name": "Shravana",
        "pada": 2,
        "lord": "Moon"
      }
    },
    {
      "label": "Person 2",
      "input_mode": "manual",
      "moon_sign": {
        "id": 6,
        "name": "Virgo",
        "degree": 8.5
      },
      "moon_nakshatra": {
        "id": 13,
        "name": "Hasta",
        "pada": 3,
        "lord": "Moon"
      }
    }
  ],
  "ashtakoota": {
    "score": 25,
    "max_score": 36,
    "percentage": 69.4,
    "recommendation": "Good Match",
    "kootas": [
      {
        "id": "varna",
        "name": "Varna",
        "score": 1,
        "max_score": 1,
        "status": "strong",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Vaishya; 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": 3,
        "max_score": 3,
        "status": "strong",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Directional Tara scores are 1.5 and 1.5."
          }
        ]
      },
      {
        "id": "yoni",
        "name": "Yoni",
        "score": 2,
        "max_score": 4,
        "status": "moderate",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Monkey; Person 2: Buffalo."
          }
        ]
      },
      {
        "id": "graha_maitri",
        "name": "Graha Maitri",
        "score": 4,
        "max_score": 5,
        "status": "strong",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Moon sign lords are Saturn and Mercury; relations are friend/neutral."
          }
        ]
      },
      {
        "id": "gana",
        "name": "Gana",
        "score": 6,
        "max_score": 6,
        "status": "strong",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Deva; Person 2: Deva."
          }
        ]
      },
      {
        "id": "bhakoot",
        "name": "Bhakoot",
        "score": 0,
        "max_score": 7,
        "status": "dosha",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Moon signs are in 9/5 relation."
          }
        ]
      },
      {
        "id": "nadi",
        "name": "Nadi",
        "score": 8,
        "max_score": 8,
        "status": "strong",
        "evidence": [
          {
            "kind": "rule_evaluation",
            "message": "Person 1: Antya; Person 2: Adi."
          }
        ]
      }
    ]
  },
  "doshas": {
    "manglik": {
      "person1": {
        "available": false,
        "active": null,
        "severity": null,
        "severity_score": null,
        "reference_frames": [],
        "cancellations": [],
        "message": "Manglik evaluation requires birth-chart input."
      },
      "person2": {
        "available": false,
        "active": null,
        "severity": null,
        "severity_score": null,
        "reference_frames": [],
        "cancellations": [],
        "message": "Manglik evaluation requires birth-chart input."
      },
      "compatibility": {
        "available": false,
        "status": "unknown",
        "message": "Manglik compatibility requires birth-chart input for both people."
      }
    },
    "nadi": {
      "active": false,
      "score": 8,
      "max_score": 8,
      "message": "Nadi score is 8 out of 8."
    },
    "bhakoot": {
      "active": true,
      "score": 0,
      "max_score": 7,
      "message": "Bhakoot score is 0 out of 7."
    }
  },
  "summary": {
    "total_score": 25,
    "max_score": 36,
    "minimum_traditional_threshold": 18,
    "passes_minimum_threshold": true,
    "risk_flags": [
      "bhakoot_dosha"
    ]
  },
  "metadata": {
    "endpoint_version": "v2",
    "ruleset_version": "astrosage_ashtakoota_v1",
    "calculation_basis": "moon_nakshatra_moon_rashi_ashtakoota",
    "person1_input_mode": "manual",
    "person2_input_mode": "manual"
  }
}

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

Совпадение по рождениюОсновная ведическая карта