API расписания

Расписания программ основных станций RadioMV: время эфира, категории и описания.

Эндпоинты

Формат ответа

{
    "schemaVersion": "2.0.0",
    "lastUpdated": "2024-12-19",
    "station": {
        "id": 1,
        "name": "English",
        "language": "en",
        "timezone": "America/Los_Angeles"
    },
    "schedule": [
        {
            "id": "1-001",
            "name": "Kids Hour",
            "description": "An hour-long children's program.",
            "category": "children",
            "days": [0, 1, 2, 3, 4, 5, 6],
            "startTime": "07:00",
            "endTime": "08:00"
        }
    ]
}

Корневые поля

Объект station

Объект элемента расписания

Дни недели

Дни представлены числами по соглашению JavaScript Date.getDay():

Формат времени

Время указывается в 24-часовом формате (HH:MM) для единообразного разбора:

Категории

Стандартизированные категории позволяют фильтровать программы на всех станциях независимо от языка:

Примеры кода

Текущая программа

function getCurrentProgram(schedule) {
    const now = new Date();
    const currentDay = now.getDay();
    const currentTime = now.toTimeString().slice(0, 5); // "HH:MM"

    return schedule.find(item =>
        item.days.includes(currentDay) &&
        item.startTime <= currentTime &&
        item.endTime > currentTime
    );
}

Расписание на сегодня

function getTodaySchedule(schedule) {
    const today = new Date().getDay();
    return schedule
        .filter(item => item.days.includes(today))
        .sort((a, b) => a.startTime.localeCompare(b.startTime));
}

Фильтр по категории

function getProgramsByCategory(schedule, category) {
    return schedule.filter(item => item.category === category);
}

// Все проповеди
const sermons = getProgramsByCategory(schedule, 'sermon');

Проверка обновлений

function isScheduleStale(data, maxAgeDays = 30) {
    const lastUpdated = new Date(data.lastUpdated);
    const now = new Date();
    const diffDays = (now - lastUpdated) / (1000 * 60 * 60 * 24);
    return diffDays > maxAgeDays;
}

Пример на Swift

func getScheduleForDay(_ schedule: [ScheduleItem], day: Int) -> [ScheduleItem] {
    return schedule
        .filter { $0.days.contains(day) }
        .sorted { $0.startTime < $1.startTime }
}

Пример на Kotlin

fun getProgramsByCategory(
    schedule: List<ScheduleItem>,
    category: String
): List<ScheduleItem> {
    return schedule.filter { it.category == category }
}