📡 API документация
API календаря Цолькин позволяет получать информацию о KIN, тонах и печатях для любой даты через HTTP запросы. Это позволяет интегрировать расчеты календаря Цолькин в ваши приложения, сайты и программы.
🔗 Базовый URL
http://tsolkin.ru/api/api.php
📋 Форматы запросов
GET запрос
Самый простой способ - передать дату через параметры URL:
GET
/api/api.php?date=DD.MM.YYYY
Пример запроса:
GET http://tsolkin.ru/api/api.php?date=08.07.1990
Или можно передать день, месяц и год отдельно:
GET
/api/api.php?day=DD&month=MM&year=YYYY
Пример запроса:
GET http://tsolkin.ru/api/api.php?day=8&month=7&year=1990
POST запрос
Для POST запросов можно использовать JSON или form-data:
JSON формат:
POST http://tsolkin.ru/api/api.php
Content-Type: application/json
{
"date": "08.07.1990"
}
Или отдельные параметры:
{
"day": 8,
"month": 7,
"year": 1990
}
📤 Формат ответа
API возвращает данные в формате JSON. При успешном запросе:
{
"success": true,
"date": {
"day": 8,
"month": 7,
"year": 1990,
"formatted": "08.07.1990"
},
"kin": 18,
"ton": {
"number": 5,
"name": "Обертонный (Overtone)",
"maya_name": "ХО",
"quality": "Сила, Радикальность, Эссенция",
"description": "Тон личной силы и самоутверждения...",
"info": "5 - Пятый элемент, усиление мощи..."
},
"seal": {
"number": 18,
"name": "Зеркало",
"full_name": "Зеркало, Нож, Кремень, Дуальность",
"maya_name": "ЭЦНАБ",
"maya_code": "Etznab",
"energy": "Отражение, Бесконечность, Порядок...",
"direction": "Север",
"color": "Белый",
"description": "Энергия отражения и истины..."
},
"portal_day": false,
"color": "#E00"
}
📊 Описание полей ответа
| Поле | Тип | Описание |
|---|---|---|
success |
boolean | Успешность запроса (true/false) |
date |
object | Информация о запрошенной дате |
date.day |
number | День месяца (1-31) |
date.month |
number | Месяц (1-12) |
date.year |
number | Год |
date.formatted |
string | Дата в формате DD.MM.YYYY |
kin |
number | KIN (число от 1 до 260) |
ton |
object | Информация о тоне (1-13) |
ton.number |
number | Номер тона (1-13) |
ton.name |
string | Название тона |
ton.maya_name |
string | Майянское название тона |
ton.quality |
string | Качество тона |
ton.description |
string | Описание тона |
seal |
object | Информация о печати/знаке (1-20) |
seal.number |
number | Номер печати (1-20) |
seal.name |
string | Название печати |
seal.full_name |
string | Полное название печати |
seal.maya_name |
string | Майянское название печати |
seal.maya_code |
string | Код печати на майянском |
seal.energy |
string | Энергия печати |
seal.direction |
string | Направление (Восток, Север, Запад, Юг) |
seal.color |
string | Цвет печати (Красный, Белый, Синий, Желтый) |
portal_day |
boolean | Является ли день портальным (Ткацкий станок) |
color |
string | Цвет дня в формате HEX |
⚠️ Обработка ошибок
При неверной дате API возвращает ошибку:
{
"success": false,
"error": "Неверная дата"
}
💻 Примеры использования
JavaScript (Fetch API)
async function getTzolkin(date) {
const response = await fetch(`http://tsolkin.ru/api/api.php?date=${date}`);
const data = await response.json();
return data;
}
// Использование:
const result = await getTzolkin('08.07.1990');
console.log(result);
JavaScript (jQuery)
$.getJSON('http://tsolkin.ru/api/api.php', {
date: '08.07.1990'
}, function(data) {
console.log(data);
});
PHP
$date = '08.07.1990';
$url = 'http://tsolkin.ru/api/api.php?date=' . urlencode($date);
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
Python
import requests
import json
date = '08.07.1990'
url = f'http://tsolkin.ru/api/api.php?date={date}'
response = requests.get(url)
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False))
cURL
curl "http://tsolkin.ru/api/api.php?date=08.07.1990"
🌐 CORS
API поддерживает CORS (Cross-Origin Resource Sharing), что позволяет использовать его напрямую из JavaScript на любом сайте. Заголовки CORS настроены для разрешения запросов с любых доменов.
📝 Примечания
- Если дата не указана, API вернет данные для текущей даты
- Формат даты: DD.MM.YYYY (например, 08.07.1990)
- API возвращает данные в кодировке UTF-8
- Все текстовые поля содержат русский язык
- KIN всегда находится в диапазоне от 1 до 260
- Тон всегда находится в диапазоне от 1 до 13
- Печать всегда находится в диапазоне от 1 до 20