GET

/api/public/matrix/{day}/{month}/{year}

Рассчитывает матрицу судьбы по дате рождения. Возвращает 12 позиций, каждая — Старший аркан Таро от 1 до 22.

Параметры пути

Параметр	Тип	Диапазон	Описание
day	integer	1–31	День рождения
month	integer	1–12	Месяц рождения
year	integer	1900–2100	Год рождения

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

bash

curl https://taliora.ru/api/public/matrix/15/3/1990

Пример ответа (200)

json

{
  "input": { "day": 15, "month": 3, "year": 1990 },
  "matrix": {
    "personal": { "arcana": 15, "name": "Дьявол", "keyword": "Материя и страсть", "emoji": "🔥" },
    "social":   { "arcana": 3,  "name": "Императрица", "keyword": "Изобилие и творчество", "emoji": "🌺" },
    "soul":     { "arcana": 18, "name": "Луна", "keyword": "Подсознание и тайна", "emoji": "🌙" },
    "body":     { "arcana": 10, "name": "Колесо Фортуны", "keyword": "Цикличность и судьба", "emoji": "🎡" },
    "spirit":   { "arcana": 10, "name": "Колесо Фортуны", "keyword": "Цикличность и судьба", "emoji": "🎡" },
    "center":   { "arcana": 10, "name": "Колесо Фортуны", "keyword": "Цикличность и судьба", "emoji": "🎡" },
    "talents":       { "arcana": 6,  "name": "Влюблённые", "keyword": "Выбор и любовь", "emoji": "💕" },
    "karma":         { "arcana": 21, "name": "Мир", "keyword": "Целостность и завершение", "emoji": "🌍" },
    "money":         { "arcana": 19, "name": "Солнце", "keyword": "Радость и жизненная сила", "emoji": "☀️" },
    "relationships": { "arcana": 11, "name": "Справедливость", "keyword": "Карма и баланс", "emoji": "⚖️" },
    "destiny":       { "arcana": 12, "name": "Повешенный", "keyword": "Жертва и новый взгляд", "emoji": "🔄" },
    "purpose":       { "arcana": 11, "name": "Справедливость", "keyword": "Карма и баланс", "emoji": "⚖️" }
  },
  "suggested_citation": "Матрица судьбы для 15.03.1990 рассчитана сервисом Taliora.ru (CC-BY 4.0)...",
  "source_url":         "https://taliora.ru/matritsa-sudby",
  "details_url":        "https://taliora.ru/profile-preview?birth=1990-03-15",
  "license":            "CC-BY 4.0",
  "attribution":        "Taliora.ru — открытый нумерологический датасет",
  "attribution_html":   "<a href=\"https://taliora.ru\" rel=\"nofollow noopener\">Расчёт: Taliora</a>",
  "api_version":        "1.0"
}

Поля matrix

Все 12 позиций имеют одинаковую структуру: arcana (число 1–22), name (русское имя аркана), keyword (ключевое слово), emoji. Значение позиции по нумерологической системе:

Поле	Название	Что означает
personal	Личность	Как человек воспринимает себя и проявляется
social	Социум	Как видят человека окружающие, его роль в группе
soul	Душа	Глубинная мотивация, прошлые жизни (в эзотерике)
body	Тело	Физика, здоровье, родовая программа
spirit	Дух	Сверх-задача, духовное направление
center	Центр	Главный аркан жизни — стержень всей матрицы
talents	Таланты	Врождённые способности и сильные стороны
karma	Карма	Кармическая задача, что нужно отработать
money	Деньги	Денежный канал — как зарабатывает
relationships	Отношения	Сценарий партнёрских отношений
destiny	Судьба	Социальная судьба, реализация во внешнем мире
purpose	Предназначение	Миссия, ради чего пришёл

Ошибки

Код	error	Когда
400	Invalid date	Параметры не проходят валидацию (нечисловые, вне диапазона, несуществующая дата — например, 30 февраля)
429	Too many requests	Превышен лимит 60 запросов/минуту/IP. Заголовок Retry-After содержит время ожидания в секундах
500	Internal error	Внутренняя ошибка. Свяжитесь с поддержкой если повторяется

Заголовки ответа

Cache-Control: public, max-age=86400, stale-while-revalidate=86400
Access-Control-Allow-Origin: * (CORS открыт всем)
X-API-License: CC-BY-4.0

CORS и preflight

Endpoint поддерживает OPTIONS preflight для cross-origin вызовов из браузера. Ответ — 204 No Content с заголовками Access-Control-Allow-Methods: GET, OPTIONS и Access-Control-Max-Age: 86400.

Быстрый старт

Дальше

GET /life-path