API расписания МИЭТ — документация и playground

API расписания МИЭТ

API v1 Read-only OpenAPI 3.0.3

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

Все рабочие endpoints требуют Bearer-токен. OpenAPI JSON доступен без токена.

Базовый адрес: https://miet-schedule.clyderedwood.com/api/v1

curl -H "Authorization: Bearer ms_live_..." \
  -H "Accept: application/json" \
  "https://miet-schedule.clyderedwood.com/api/v1/groups?per_page=20"
Открыть OpenAPI JSON

Playground

Ответ API 
Выберите запрос и нажмите «Выполнить».

Статус и время

Состояние данных, активный семестр и сетка пар.

Статус API.

Необходимые права
status:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Активный семестр.

Необходимые права
status:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Состояние загруженных данных.

Необходимые права
status:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Время учебных пар.

Необходимые права
status:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Справочники

Группы, преподаватели, аудитории и общий поиск.

Список и поиск групп.

Необходимые права
groups:read
Параметры
q, page, per_page
Успешный ответ
JSON с полем data и, при наличии, meta.

Поиск групп.

Необходимые права
groups:read
Параметры
q, page, per_page
Успешный ответ
JSON с полем data и, при наличии, meta.

Список и поиск преподавателей.

Необходимые права
teachers:read
Параметры
q, page, per_page
Успешный ответ
JSON с полем data и, при наличии, meta.

Поиск преподавателей.

Необходимые права
teachers:read
Параметры
q, page, per_page
Успешный ответ
JSON с полем data и, при наличии, meta.

Список и поиск аудиторий.

Необходимые права
rooms:read
Параметры
q, page, per_page
Успешный ответ
JSON с полем data и, при наличии, meta.

Поиск аудиторий.

Необходимые права
rooms:read
Параметры
q, page, per_page
Успешный ответ
JSON с полем data и, при наличии, meta.

Поиск по всем справочникам.

Необходимые права
groups:read, teachers:read, rooms:read
Параметры
q
Успешный ответ
JSON с полем data и, при наличии, meta.

Расписание

Расписание групп, преподавателей, аудиторий и свободные помещения.

Расписание группы.

Необходимые права
groups:read, schedule:read
Параметры
date или from + to
Успешный ответ
JSON с полем data и, при наличии, meta.

Группа сегодня.

Необходимые права
groups:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Группа завтра.

Необходимые права
groups:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Группа на неделю.

Необходимые права
groups:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Текущая пара группы.

Необходимые права
groups:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Следующая пара группы.

Необходимые права
groups:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Расписание преподавателя.

Необходимые права
teachers:read, schedule:read
Параметры
date или from + to
Успешный ответ
JSON с полем data и, при наличии, meta.

Текущая пара преподавателя.

Необходимые права
teachers:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Следующая пара преподавателя.

Необходимые права
teachers:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Расписание аудитории.

Необходимые права
rooms:read, schedule:read
Параметры
date или from + to
Успешный ответ
JSON с полем data и, при наличии, meta.

Текущее занятие в аудитории.

Необходимые права
rooms:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Следующее занятие в аудитории.

Необходимые права
rooms:read, schedule:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Занятость аудитории.

Необходимые права
rooms:read, schedule:read
Параметры
date
Успешный ответ
JSON с полем data и, при наличии, meta.

Свободные аудитории.

Необходимые права
free_rooms:read
Параметры
date, pair
Успешный ответ
JSON с полем data и, при наличии, meta.

Свободные аудитории сейчас.

Необходимые права
free_rooms:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Свободные аудитории на следующей паре.

Необходимые права
free_rooms:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Изменения и bulk

История обновлений и чтение нескольких расписаний за один запрос.

Последние изменения.

Необходимые права
changes:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Изменения группы.

Необходимые права
changes:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Изменения преподавателя.

Необходимые права
changes:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Изменения аудитории.

Необходимые права
changes:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Diff версии расписания.

Необходимые права
changes:read
Параметры
Нет
Успешный ответ
JSON с полем data и, при наличии, meta.

Несколько групп.

Необходимые права
bulk:read, schedule:read
Параметры
JSON: groups, date или from + to
Успешный ответ
JSON с полем data и, при наличии, meta.

Несколько преподавателей.

Необходимые права
bulk:read, schedule:read
Параметры
JSON: teachers, date или from + to
Успешный ответ
JSON с полем data и, при наличии, meta.

Несколько аудиторий.

Необходимые права
bulk:read, schedule:read
Параметры
JSON: rooms, date или from + to
Успешный ответ
JSON с полем data и, при наличии, meta.

Лимиты

ЗаголовокЗначение
X-RateLimit-LimitЛимит токена в минуту
X-RateLimit-RemainingОсталось запросов в текущем окне
X-RateLimit-ResetВремя сброса в Unix timestamp
X-RateLimit-Daily-*Дневные значения, если лимит настроен
Retry-AfterПауза после ответа 429

Ошибки

Структура одинакова для ошибок авторизации, валидации и лимитов.

unauthorized forbidden token_expired token_revoked not_found validation_error rate_limited maintenance server_error 
{
  "error": {
    "code": "validation_error",
    "message": "Проверьте параметры запроса.",
    "details": {
      "date": ["Дата должна быть в формате YYYY-MM-DD."]
    }
  }
}

Примеры с текущими данными

Группа
Аспирантура 11
Преподаватель
Агамалиев Рустам Тельман оглы
Аудитория
1201 м
const response = await fetch('https://miet-schedule.clyderedwood.com/api/v1/groups?per_page=20', {
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer ms_live_...'
  }
});

const payload = await response.json();
На этой странице