Содержание API

Обзор Быстрый старт Авторизация Методы Примеры Песочница Тарифы Ошибки

Arcanos API v1HTTP · JSON · ключ в заголовке

API для астрологических расчётов

Матрица судьбы, натальная карта с домами и аспектами, синастрия, транзиты, ведическая и славянская карта. Один ключ, предсказуемые JSON-ответы и 50 бесплатных запросов каждый месяц.

Получить API-ключ OpenAPI JSON

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

Три шага до первого запроса

01
Создайте аккаунт
Бесплатный тариф включается сразу, карта не нужна.
02
Создайте ключ
В кабинете, раздел API. Ключ показывается один раз — сохраните его.
03
Вызовите метод
Передайте заголовок Authorization: Bearer <ключ> и JSON в теле.

Авторизация

Ключ в заголовке

Ключ создаётся в аккаунте Arcanos и действует, пока вы его не отозвали. Передавайте его в заголовке Authorization — этого достаточно для любого метода.

Authorization: Bearer ark_live_...

Альтернатива — заголовок X-API-Key. Ключ показывается один раз при создании; копию храните у себя.

curl -X POST https://arcanos.ru/api/v1/matrix \
  -H "Authorization: Bearer ark_live_..." \
  -H "Content-Type: application/json" \
  -d '{"date":"1994-06-17"}'

Методы

Полный список v1

Одиннадцать методов: два служебных и девять расчётных. Формат тела — JSON, ответ — JSON.

Метод	Путь	Описание
GET	/api/v1/health	Публичный health-check сервиса и эфемерид.
GET	/api/v1/me	Тариф, лимит, остаток и дата сброса.
POST	/api/v1/matrix	Матрица судьбы по дате рождения.
POST	/api/v1/natal	Натальная карта: дома, планеты, звёзды, аспекты.
POST	/api/v1/synastry	Две карты и межкартные аспекты.
POST	/api/v1/compatibility	Совместимость по двум датам.
POST	/api/v1/transits	Положения неба на выбранную дату.
POST	/api/v1/vedic	Ведическая карта D1 и панчанг.
POST	/api/v1/slavic	Славянский тотем и чертог по дате.
POST	/api/v1/wheel	Модель колеса матрицы: секторы, метки, цикл.
GET	/api/v1/horoscope?date=...&sign=aries	Гороскоп по знаку и дате.

Примеры

Один запрос — шесть языков

Выберите метод и язык. Примеры готовы для копирования: cURL, TypeScript, Python, PHP, Kotlin и Java.

Пример запросаМатрица

Метод

cURL

TypeScript

Python

PHP

Kotlin

Java

const res = await fetch("https://arcanos.ru/api/v1/matrix", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.ARCANOS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "date": "1994-06-17"
}),
});

if (!res.ok) throw new Error(await res.text());
const { data } = await res.json();
console.log(data);

Примеры

Запрос и ответ

Натальная карта

Дома, планеты, неподвижные звёзды и аспекты. Нужны время и место.

curl -X POST https://arcanos.ru/api/v1/natal \
  -H "Authorization: Bearer ark_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1994-06-17",
    "time": "08:30",
    "city": "moscow",
    "houseSystem": "PLACIDUS"
  }'

Синастрия

Две карты и связи между ними: притяжение, быт, задача пары.

curl -X POST https://arcanos.ru/api/v1/synastry \
  -H "Authorization: Bearer ark_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "first":  {"date":"1994-06-17","time":"08:30","city":"moscow"},
    "second": {"date":"1992-08-21","time":"15:20","city":"spb"}
  }'

Объект Birth

Одна структура для всех расчётных методов. Вместо города можно передать latitude и longitude.

{
  "date": "1994-06-17",
  "time": "08:30",
  "city": "moscow",
  "timezone": "Europe/Moscow",
  "houseSystem": "PLACIDUS",
  "zodiac": "TROPICAL"
}

Время необязательно: без него берётся 12:00, дома и ASC будут приблизительными.

Ответ и ошибки

Успешный ответ лежит в data, ошибка — в error.code и error.message.

{ "data": { ... } }

{ "error": { "code": "validation_error",
             "message": "date must be YYYY-MM-DD." } }

Квота списывается за каждый запрос с валидным ключом.

Ответы

Что возвращает каждый метод

/matrix

9 точек, годовой аркан, signature

Дата рождения

/natal

ASC, MC, дома, планеты, звёзды, аспекты

Дата, время, место

/synastry

Две карты и межкартные аспекты

Два объекта Birth

/compatibility

Три общих аркана пары

Две даты

/transits

Небо на момент и дома

Дата и место

/vedic

D1, накшатры, даши, панчанг

Дата, время, место

/slavic

Тотем, чертог, стихия

Дата

/wheel

Секторы, метки и цикл колеса

Дата или пара

/horoscope

День, неделя и небо

Дата и знак

/me

Лимит, остаток, сброс

Ключ

/health

Статус сервиса и эфемерид

Без ключа

Песочница

Проверьте запрос здесь

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

live · /api/v1

МетодAPI-ключ только в этом браузере

JSON тела

POST /api/v1/matrixответ появится здесь

// Песочница отправит настоящий запрос к /api/v1.
// Ключ не сохраняется на сервере документации.

Тарифы

Запросы по месяцам

Один аккаунт — один лимит: ключи не делят квоту между собой и не увеличивают её. Счётчик общий по всем ключам.

С подпиской «Навигатор» — 1 000 запросов в месяц. Она входит в месячный и годовой тариф, отдельный API-ключ создаётся в кабинете.

Бесплатный0 ₽в месяц50 запросов в месяц

Для знакомства и небольших проектов.

50 запросов в месяц
Все базовые endpoints
API-ключ в кабинете
Лимит по аккаунту

Входит в каждый аккаунтСоздать ключ

Start790 ₽в месяц2 500 запросов в месяц

Для небольших приложений и ботов.

2 500 запросов в месяц
Все endpoints
Приоритетная поддержка
Повышенный лимит

Scale1 990 ₽в месяц10 000 запросов в месяц

Для продуктов с реальным трафиком.

10 000 запросов в месяц
Все endpoints
Приоритетная поддержка
Помощь с интеграцией

Business5 990 ₽в месяц50 000 запросов в месяц

Для агентств и крупных интеграций.

50 000 запросов в месяц
Все endpoints
Приоритетная поддержка
Договор и счёт

Ошибки

401 — нет ключа или ключ отозван.
400 — неверный JSON или дата.
429 — месячный лимит исчерпан.
503 — эфемеридный движок недоступен.

Бесплатно

50 запросов в месяц доступны каждому аккаунту без карты. Для большого трафика хватит тарифов на 2 500, 10 000 и 50 000 запросов. Вопросы по интеграции — hello@arcanos.ru.