Перейти к содержимому
НАТАЛКАastrology, computed
Для разработчиков

JSON API и MCP

Расчёт натальной карты как данные: положения, дома, аспекты, баланс стихий. Без ключа, с ограничением 30 запросов в минуту на IP.

POST /api/chart

curl -X POST https://natalka.matlahoff.ru/api/chart \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-01-15",
    "time": "12:00",
    "timeZone": "Europe/Moscow",
    "latitude": 55.7558,
    "longitude": 37.6173,
    "houseSystem": "P"
  }'

GET /api/chart

Те же параметры в query string: date, time, tz, lat, lon, system, unknownTime.

Ответ

Возвращается объект с полями meta, planets, houses, angles, aspects, balance, bigThree, warnings. Пример — на странице калькулятора, кнопка «JSON».

MCP

Эндпоинт POST /mcp поддерживает JSON-RPC 2.0: initialize, tools/list, tools/call. Инструмент — calculate_natal_chart.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calculate_natal_chart",
    "arguments": {
      "date": "1990-01-15",
      "time": "12:00",
      "timeZone": "Europe/Moscow",
      "latitude": 55.7558,
      "longitude": 37.6173
    }
  }
}

Ограничения

  • 30 запросов в минуту на IP.
  • Без точного времени дома и Асцендент помечаются как ненадёжные.
  • Результат не является предсказанием; указывайте это при использовании.

Коды ошибок

КодЗначение
400Неверные параметры
429Слишком много запросов
500Ошибка расчёта