API расписания Raspika

Три шага до первого расписания:

1. Получите ключ: напишите в поддержку на raspika.com.
2. Узнайте идентификатор заведения и группы: методы /institutions и /groups.
3. Запросите расписание: /schedule. Хотите готовый текст для поста, добавьте &format=text.

# 1. какие есть заведения
curl -H "X-Api-Key: ВАШ_КЛЮЧ" https://raspika.com/api/v1/institutions

# 2. найти свою группу (пример: ОмГТУ, группы на «ИСТ-25»)
curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://raspika.com/api/v1/groups?inst=omgtu&q=ИСТ-25"

# 3. расписание группы готовым текстом
curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://raspika.com/api/v1/schedule?inst=omgtu&group=421&format=text"

Базовый адрес: https://raspika.com/api/v1. Все методы это GET, ответы в JSON, кодировка UTF-8.

Это единственное жёсткое требование. Оно нужно, чтобы человек понимал, откуда данные, и знал, куда идти за уведомлениями об отменах и переносах.

Где именно ставить пометку

• в посте, если публикуете расписание в паблике;
• в сообщении бота, где показываются пары;
• на странице сайта или в виджете, рядом с таблицей.

Достаточно одной строки внизу. Ссылка на raspika.com приветствуется, но обязателен именно текст.

Проще всего не писать её самому

Добавьте format=text, и API вернёт готовый текст, в конце которого пометка уже стоит. Вам останется только опубликовать его. Подробно в разделе «Готовый текст».

Личная ссылка и как мы проверяем пометку

Вместе с ключом выдаётся личная ссылка вида raspika.com/r/ab12cd. Она приходит в каждом ответе в поле attribution_link, а в готовом тексте уже подставлена в пометку. Ведёт она на обычную главную страницу, но по переходам видно, что пометка действительно опубликована, а вы видите, сколько людей она приводит.

Кроме этого раз в сутки автоматика заходит на площадку, которую вы указали при получении ключа (паблик ВК, телеграм-канал или страницу сайта), и проверяет, есть ли там упоминание Raspika. Это не слежка, а способ держать договорённость в силе без переписки.

Если запросы идут, а пометки нигде нет, мы сначала пишем на ваш контакт. Молчание или отказ означает блокировку ключа.

Что можно

• кэшировать ответы у себя, пересобирать в свой формат, менять оформление;
• показывать расписание в боте, на сайте, в приложении, в паблике;
• использовать в некоммерческих и коммерческих проектах.

Что нельзя

• убирать пометку об источнике;
• выдавать данные за собственный сбор с сайтов вузов;
• перепродавать доступ к самому API;
• долбить API в обход лимитов, пытаясь выкачать всё подряд.

Нарушение решается просто: ключ блокируется, данные перестают приходить. Перед блокировкой мы пишем на контакт, который вы оставили.

Напишите в поддержку на raspika.com и укажите:

• кто вы и что за проект;
• где будут показываться данные: ссылка на паблик, бота или сайт;
• примерный объём: сколько запросов в сутки ожидаете;
• адрес площадки, куда пойдут данные: он нужен, чтобы автоматика видела пометку и не беспокоила вас лишний раз.

Ключ выдаётся вручную, обычно в тот же день. Выглядит так: rk_api_XXXXXXXXXXXXXXXXXXXXXX.

Ключ бесплатный и бессрочный. Отзывается только при нарушении условий.

Два способа, оба рабочие:

# заголовком (рекомендуется)
curl -H "X-Api-Key: ВАШ_КЛЮЧ" https://raspika.com/api/v1/institutions

# параметром в адресе
curl "https://raspika.com/api/v1/institutions?key=ВАШ_КЛЮЧ"

Мы со своей стороны маскируем ключи в журнале доступа, поэтому в наших логах вместо ключа остаётся key=***.

Если ключ утёк, напишите в поддержку: заблокируем старый и выдадим новый.

Справочник учебных заведений. Поле key каждого элемента это то, что подставляется в параметр inst остальных методов.

curl -H "X-Api-Key: ВАШ_КЛЮЧ" https://raspika.com/api/v1/institutions

{
  "data": [
    {"key": "omgtu", "name": "ОмГТУ", "short": "ОмГТУ",
     "src": "https://rasp.omgtu.ru/", "live": true},
    {"key": "omgmu", "name": "ОмГМУ", "short": "ОмГМУ", "live": true}
  ],
  "source": "raspika.com",
  "attribution": "Расписание взято с raspika.com",
  "attribution_required": true,
  "docs": "https://raspika.com/api.html"
}

Группы заведения. Список большой (у ОмГТУ больше тысячи), поэтому есть фильтр.

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://raspika.com/api/v1/groups?inst=omgtu&q=ИСТ-25"

{
  "data": [
    {"id": "421", "name": "ИСТ-253", "course": null},
    {"id": "419", "name": "ИСТ-251", "course": null}
  ],
  "inst": "omgtu",
  "count": 2,
  "attribution": "Расписание взято с raspika.com"
}

id это то, что подставляется в параметр group. У разных заведений идентификаторы выглядят по-разному: где-то число, где-то само название группы, где-то адрес файла. Не пытайтесь их угадывать, берите из этого метода.

Расписание группы. По умолчанию отдаётся окно примерно в месяц: неделя назад и до четырёх недель вперёд, насколько хватает данных у источника.

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://raspika.com/api/v1/schedule?inst=omgtu&group=421&date_from=2026-09-23&date_to=2026-09-23"

{
  "data": [
    {"date": "2026-09-23", "num": 2, "start": "09:40", "end": "11:10",
     "subject": "Физическая культура", "type": "Практика",
     "teacher": "Колтошова Т.В.", "room": "ФК-Спортзал",
     "subgroup": 0, "parity": null, "changed": false}
  ],
  "inst": "omgtu", "group": "421", "count": 1,
  "stale": false, "updated_at": "2026-09-22T13:40:11",
  "attribution": "Расписание взято с raspika.com"
}

Журнал изменений: что отменили, перенесли или добавили. Мы сверяем расписание всех отслеживаемых групп каждые 20 минут и записываем отличия. Этот метод отдаёт записи журнала.

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://raspika.com/api/v1/changes?inst=omgtu&group=421&since=2026-09-20&format=text"

{
  "data": [
    {"ts": 1790077000.5, "inst": "omgtu", "group": "421", "group_name": "ИСТ-253",
     "added": [ ... пары ... ],
     "removed": [ ... пары ... ],
     "changed": [{"lesson": { ... }, "was": { ... }, "fields": ["room"]}]}
  ],
  "count": 1,
  "text": "ИСТ-253 · изменения\n...\n\nРасписание взято с raspika.com",
  "attribution": "Расписание взято с raspika.com"
}

Чтобы не собирать текст руками и не забывать про пометку, добавьте format=text к /schedule или /changes. В ответе появится поле text: готовое сообщение, где последняя строка это «Расписание взято с raspika.com».

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \
  "https://raspika.com/api/v1/schedule?inst=omgtu&group=421&format=text"

ИСТ-253 · Среда, 23 сентября
2 пара 09:40-11:10 · Физическая культура · ФК-Спортзал, Колтошова Т.В.
3 пара 11:35-13:05 · Стандартизация · 6-429, Андиева Е.Ю.

Расписание взято с raspika.com

Этот текст можно без изменений отправить в телеграм, ВК или опубликовать постом: условие использования будет выполнено автоматически.

Если делаете своё оформление, возьмите строку из поля attribution и добавьте её в конец, тогда текст пометки всегда совпадёт с актуальным. А чтобы пометка была кликабельной и считала переходы, используйте attribution_link или готовую строку attribution_html:

{
  "attribution": "Расписание взято с raspika.com",
  "attribution_link": "https://raspika.com/r/ab12cd",
  "attribution_html": "<a href="https://raspika.com/r/ab12cd">Расписание взято с raspika.com</a>"
}

Поля пары

Служебные поля ответа

Если stale равно true, покажите это и своим пользователям: расписание могло успеть измениться. У нас на сайте в таком случае выводится строка «сайт вуза недоступен, показана сохранённая версия».

Тело ошибки выглядит так: {"detail": "Группа не найдена"}.

Лимиты

• 120 запросов в минуту на ключ;
• 300 запросов в минуту с одного адреса, суммарно по всем ключам;
• расписание на нашей стороне обновляется раз в 30 минут, чаще спрашивать бессмысленно.

Если нужен объём больше, напишите в поддержку, обсудим. Лучше всего кэшировать ответы у себя хотя бы на 10 минут: и вам быстрее, и нам спокойнее.

Бот, который утром публикует расписание на сегодня

Раз в сутки дёргаете /schedule с date_from=date_to=сегодня и format=text, публикуете поле text. Пометка внутри.

Паблик, который сообщает об отменах

Раз в 20-30 минут запрашиваете /changes?inst=...&group=...&since=время_прошлого_запроса&format=text. Если count больше нуля, публикуете text. Время последнего успешного запроса храните у себя.

Расписание на своём сайте

Ходите за данными с сервера, кэшируйте на 10-15 минут, рисуйте своей вёрсткой. Под таблицей выводите строку из поля attribution.

Выбор группы для пользователя

Один раз в сутки забираете /groups нужных заведений, храните у себя и ищете по ним локально: списки меняются редко, а запросы экономятся.

Python

import httpx, datetime

KEY = "ВАШ_КЛЮЧ"
BASE = "https://raspika.com/api/v1"
H = {"X-Api-Key": KEY}

d = (datetime.date.today() + datetime.timedelta(days=1)).isoformat()
r = httpx.get(f"{BASE}/schedule",
              params={"inst": "omgtu", "group": "421",
                      "date_from": d, "date_to": d, "format": "text"},
              headers=H, timeout=30).json()

if r["count"]:
    print(r["text"])          # пометка уже внутри текста
else:
    print("Завтра пар нет")

JavaScript (Node.js)

const KEY = process.env.RASPIKA_KEY;

const res = await fetch(
  "https://raspika.com/api/v1/schedule?inst=omgtu&group=421&format=text",
  { headers: { "X-Api-Key": KEY } }
);
const data = await res.json();

console.log(data.text);       // готовый текст с пометкой
console.log(data.count, "пар,", data.stale ? "копия" : "свежие данные");

PHP

<?php
$key = getenv('RASPIKA_KEY');
$url = 'https://raspika.com/api/v1/schedule?inst=omgtu&group=421&format=text';

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["X-Api-Key: $key"],
  CURLOPT_TIMEOUT => 30,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $data['text'];           // пометка внутри

Свой формат с пометкой

r = httpx.get(f"{BASE}/schedule",
              params={"inst": "omgtu", "group": "421"},
              headers=H, timeout=30).json()

lines = []
for l in r["data"]:
    lines.append(f"{l['num']} пара · {l['subject']} · {l['room']}")
lines.append("")
lines.append(r["attribution"])   # берём строку из ответа, не пишем руками
text = "\n".join(lines)

Это бесплатно?

Да. Единственное условие это пометка об источнике.

Откуда данные?

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

Какие заведения есть?

На момент написания 18: ОмГТУ, ОмГУ, ОмГМУ (и медколледж), ОмГУПС, СибАДИ, ОмГПУ, ОмГАУ, СибГУФК, ОмГА, СибИТ, СибГУОР, музпед, ОАТК, строительный колледж и другие. Актуальный список всегда в /institutions.

Можно ли добавить заведение, которого нет?

Напишите в поддержку. Если у заведения есть расписание в открытом виде, обычно подключаем за день-два.

Насколько свежие данные?

Обновление каждые 30 минут. Поле updated_at показывает время последнего обновления, stale предупреждает, если отдана сохранённая копия.

Что будет, если я уберу пометку?

Мы напишем на ваш контакт. Если ничего не изменится, ключ будет заблокирован.

Можно ли получать уведомления push, а не опрашивать?

Пока нет, вебхуков нет. Опрашивайте /changes раз в 20-30 минут, этого достаточно: чаще мы и сами не проверяем. Если нужен вебхук, напишите, посмотрим на спрос.

Есть ли ограничение на аудиторию моего проекта?

Нет. Чем больше студентов увидят расписание, тем лучше. Главное, чтобы они знали, откуда оно.

Поддержка

Вопросы, ключи, подключение новых заведений: чат поддержки на raspika.com. Отвечаем сами, без роботов.