{
    "name": "Lunar Portal API",
    "version": "1.0",
    "description": "API для получения лунных данных и информации о городах",
    "base_url": "https:\/\/www.lunafaza.ru\/api",
    "endpoints": [
        {
            "path": "\/city.php",
            "method": "GET",
            "description": "Получить лунные данные для конкретного города",
            "parameters": {
                "slug": "Идентификатор города (обязательный)",
                "city": "Альтернативный параметр для slug"
            },
            "example": "\/api\/city.php?slug=moscow",
            "response": {
                "success": true,
                "city": [
                    "name",
                    "region",
                    "coordinates",
                    "timezone"
                ],
                "moon": [
                    "phase",
                    "phase_name",
                    "illumination_percent",
                    "age_days"
                ],
                "sun": [
                    "sunrise",
                    "sunset",
                    "day_length"
                ],
                "recommendations": [
                    "gardening",
                    "beauty",
                    "business",
                    "home"
                ]
            }
        },
        {
            "path": "\/cities.php",
            "method": "GET",
            "description": "Получить список всех городов",
            "parameters": {
                "format": "full или compact (по умолчанию: full)",
                "region": "Фильтр по региону",
                "search": "Поиск по названию",
                "limit": "Максимальное количество результатов",
                "group_by": "region - группировка по регионам"
            },
            "example": "\/api\/cities.php?format=compact&limit=10",
            "response": {
                "success": true,
                "total": "количество городов",
                "cities": [
                    "массив городов"
                ],
                "statistics": [
                    "общая статистика"
                ]
            }
        },
        {
            "path": "\/regions.php",
            "method": "GET",
            "description": "Получить список регионов с городами",
            "parameters": [],
            "example": "\/api\/regions.php",
            "response": {
                "success": true,
                "regions": [
                    "массив регионов с городами"
                ],
                "statistics": [
                    "статистика по регионам"
                ]
            }
        },
        {
            "path": "\/moon.php",
            "method": "GET",
            "description": "Получить лунные данные для произвольных координат",
            "parameters": {
                "lat": "Широта (по умолчанию: 55.7558)",
                "lon": "Долгота (по умолчанию: 37.6176)",
                "date": "Дата в формате YYYY-MM-DD (по умолчанию: сегодня)",
                "time": "Время в формате HH:MM (по умолчанию: сейчас)"
            },
            "example": "\/api\/moon.php?lat=59.9311&lon=30.3609&date=2024-12-25",
            "response": {
                "success": true,
                "location": [
                    "coordinates"
                ],
                "moon": [
                    "phase data"
                ],
                "sun": [
                    "sunrise\/sunset"
                ],
                "next_phases": [
                    "upcoming phases"
                ]
            }
        }
    ],
    "error_codes": {
        "400": "Bad Request - неверные параметры",
        "404": "Not Found - ресурс не найден",
        "500": "Internal Server Error - ошибка сервера"
    },
    "rate_limits": {
        "requests_per_hour": 1000,
        "requests_per_minute": 60
    },
    "examples": {
        "Получить данные для Москвы": "\/api\/city.php?slug=moscow",
        "Найти города в Московской области": "\/api\/cities.php?region=Московская",
        "Лунные данные для СПб на Новый год": "\/api\/moon.php?lat=59.9311&lon=30.3609&date=2024-12-31&time=23:59",
        "Компактный список первых 5 городов": "\/api\/cities.php?format=compact&limit=5"
    },
    "contact": {
        "website": "https:\/\/www.lunafaza.ru",
        "support": "support@www.lunafaza.ru"
    }
}