/api/astro/shodasamsa/1 кредитШодашамша (D16)
Шодашамша, шестнадцатая дробная карта, она же каламша: каждый знак делится на шестнадцать частей по 1°52'30". По ней судят о транспорте, удобствах и о том, сколько радости они приносят на самом деле, — в отличие от средств на их покупку. Возвращает ту же плоскую структуру, что и /api/astro/planet-positions/: планеты списком в традиционном порядке, у каждой — `name`, долгота, знак, накшатра, пада и дом, а также асцендент и применённая аянамша. Карта зафиксирована маршрутом, поэтому `chart_name` в теле запроса игнорируется — этот эндпоинт не может вернуть ничего, кроме этой дробной карты.
https://api.occultapi.com/api/astro/shodasamsa/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| chart_name | string | обязательный | |
| datetime | string (date-time) | обязательный | Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC. То же, что date_time: другие эндпоинты называют это поле иначе. |
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -89.9 · max 89.9 |
| longitude | number (double) | обязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180 |
| aberration | boolean | необязательный | |
| apply_correction | boolean | необязательный | |
| ascendant_pos | string | необязательный | cuspstartend |
| ayanamsa | string | необязательный | |
| background_color | string | необязательный | Hex-цвет фона SVG. |
| chart_style | string | необязательный | Стиль диаграммы при render='svg'. 'north' — ромбовидная схема с фиксированными домами и смещающимися знаками; 'south' — сетка с фиксированными знаками и смещающимися домами. northsouth |
| correction_deg | integer | необязательный | min 0 |
| correction_direction | string | необязательный | addsubtract |
| correction_min | integer | необязательный | min 0 · max 59 |
| correction_sec | integer | необязательный | min 0 · max 59 |
| extended_bodies | array | необязательный | Какие группы тел включить: 'asteroids', 'planetary_moons', 'fictitious_bodies'. |
| label_style | string | необязательный | Как подписываются планеты: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) или 'symbol' (☉, ☽, ...). englishsanskritsymbol |
| line_color | string | необязательный | Hex-цвет линий сетки карты. |
| notation | string | необязательный | astrologicaldegree |
| nutation | boolean | необязательный | |
| planet_color | string | необязательный | Hex-цвет подписей планет, например '#111827'. По умолчанию — собственный цвет темы. |
| rahu | string | необязательный | Какие узлы включить. 'true' — только истинные узлы, 'mean' — только средние, 'both' — оба типа. truemeanboth |
| refraction | boolean | необязательный | |
| render | string | необязательный | Укажите 'svg', чтобы дополнительно получить отрисованную диаграмму карты (см. chart_style) и лежащую в её основе геометрию. Если параметр не передавать, ответ не изменится. nonesvg |
| show_degrees | boolean | необязательный | Показывать рядом с подписью каждого тела его градус в знаке. |
| sign_color | string | необязательный | Hex-цвет номеров и сокращений знаков. |
| svg_size | integer | необязательный | Ширина и высота квадратного SVG viewBox в пикселях. min 100 · max 2000 |
| theme | string | необязательный | lightdark |
| true_mean | string | необязательный | TrueMean |
| use_28_nakshatras | boolean | необязательный |
Пример запроса
Этот пример ещё не проверен
Названия и типы полей ниже взяты из описания API, и они точны. Но именно это тело запроса при последнем запуске не вернуло успешного ответа: возможно, ему не хватает значения, которое мы не можем угадать. Считайте его заготовкой, а не готовой командой.
curl -X POST https://api.occultapi.com/api/astro/shodasamsa/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"chart_name":"string","datetime":"2026-09-01 06:00:00","latitude":26.9124,"longitude":75.7873,"ascendant_pos":"cusp","chart_style":"north","correction_direction":"add","label_style":"english","notation":"astrological","rahu":"true","render":"none","theme":"light","true_mean":"True"}'Ответ
Проверенного примера ответа для этого эндпоинта пока нет. Структура запроса выше сгенерирована из описания API и точна. Примеры ответов мы публикуем, только когда проверим их на реальном вызове.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.