api.dnevnik.ru wrapper

Упрощение работы с api всероссийского электронного дневника как с токеном, так и без него.

Установка

pip install pydnevnikruapi

или

pip install https://github.com/kesha1225/DnevnikRuAPI/archive/master.zip --upgrade

Документация

Документация доступна здесь - https://kesha1225.github.io/DnevnikRuAPI/ По методам здесь - https://api.dnevnik.ru/partners/swagger/ui/index

Пример синхронного использования

Получение домашнего задания на указанный период без токена.

from pydnevnikruapi.dnevnik import dnevnik
from datetime import datetime

login = "login"
password = "password"
# Получаем доступ через логин и пароль

dn = dnevnik.DiaryAPI(login=login, password=password)

print(dn.get_school_homework(1000002283077, datetime(2019, 9, 5), datetime(2019, 9, 15)))
#  Получение домашнего задания текущего пользователя для школы с id 1000002283077 в период с 05-09-2019 по 15-09-2019

print(dn.get_edu_groups())
#  Получение групп обучения текущего пользователя

Пример асинхронного использования

Получение домашнего задания на указанный период без токена.

from pydnevnikruapi.aiodnevnik import dnevnik
from pydnevnikruapi.aiodnevnik.utils import TaskManager
import asyncio
from datetime import datetime


async def get_dn_info():
    homework = await dn.get_school_homework(
        1000002283077, str(datetime(2019, 9, 5)), str(datetime(2019, 9, 15))
    )
    #  Получение домашнего задания текущего пользователя для школы с id 1000002283077 в период с 05-09-2019 по 15-09-2019
    print(homework)

    edu_groups = await dn.get_edu_groups()
    #  Получение групп обучения текущего пользователя
    print(edu_groups)


async def close_session():
    await dn.close_session()
    #  В конце использования закрываем сессию


if __name__ == "__main__":
    login = "login"
    password = "password"
    dn = dnevnik.AsyncDiaryAPI(login=login, password=password)
    # Получаем доступ через логин и пароль

    loop = asyncio.get_event_loop()
    # Добавляем все наши функции в event loop через Task Manager

    task_manager = TaskManager(loop)
    task_manager.add_task(get_dn_info)
    task_manager.run(on_shutdown=close_session)
    # Закрываем сессию по завершению работы

Пример неописанного метода

from pydnevnikruapi.dnevnik import dnevnik


dn = dnevnik.DiaryAPI(login="login", password="password")

# допустим тут метод которого нет в библиотеке но он есть в доке свагера
context = dn.get(f"users/me/context")

# то же самое с пост методами итд (это работать не будет просто прмиер)
lesson_log = dn.post(
    f"lessons/123/log-entries",
    data={"lessonLogEntry": "data"},
)

Чтобы пропустить шаг завершения сессии в последнем примере воспользуйтесь примером

Соотнесение апи методов и методов pydnevnikruapi

/v2.0/users/me/organizations - get_organizations() - Список идентификаторов организаций текущего пользователя

/v2.0/users/me/organizations/{organizationId} - get_organization_info(organization_id: int) - Данные указанной организации пользователя

/v2.0/authorizations - get_token(login, password) - Обменять код доступа на токен

/v2.0/persons/{person}/reporting-periods/{period}/avg-mark - get_person_average_marks(person: int, period: int) - Оценки персоны за отчетный период

/v2.0/edu-groups/{group}/reporting-periods/{period}/avg-marks/{date} - get_group_average_marks_by_date( group_id: int, period: int, date: datetime.datetime) - Оценки учебной группы по предмету за отчетный период до определенной даты

/v2.0/edu-groups/{group}/avg-marks/{from}/{to} - get_group_average_marks_by_time(group_id: int, start_time: datetime.datetime, end_time: datetime.datetime) - Оценки учебной группы за период

/v2.0/user/{userID}/children - get_user_children(user_id: int) - Получение списка детей по идентификатору родительского пользователя

/v2.0/person/{personID}/children - get_person_children(person_id: int) - Получение списка детей по идентификатору родительской персоны

/v2.0/users/me/classmates - get_classmates() - Список id пользователей одноклассников текущего пользователя, если он является учеником, либо список активных участников образовательных групп пользователя во всех остальных случаях

/v2.0/users/me/context - get_context() - Получение контекстной информации по пользователю

/v2.0/users/{userId}/context - get_user_context(user_id: int) - Получение контекстной информации по пользователю

/v2.0/edu-group/{group}/subject/{subject}/period/{period}/criteria-marks-sections - func - Метод получения списка секций СОр + СОч для класса по предмету в выбранном периоде c соответствующей информацией

/v2.0/edu-group/{group}/person/{person}/subject/{subject}/period/{period}/criteria-marks - func - Метод получения суммативных оценок (СОр, СОч) ученика класса по предмету за период, с привязкой к конкретной теме/суммативной оценки четверти

/v2.0/edu-group/{group}/period/{period}/criteria-marks - func - Метод получения списка оценок (СОр, СОч) класса сгруппированные по ученикам и предметам за период (т.е. оценки каждого ученика класса, разбитые по предметам)

/v2.0/edu-group/{group}/subject/{subject}/period/{period}/criteria-marks - func - Метод получения всех оценок (СОр и СОч) класса (группировка по ученикам) за период по выбранному предмету

/v2.0/edu-group/{group}/criteria-marks-totals - get_final_group_marks(group_id: int) - Метод, позволяющий получить итоговые оценки всего класса (каждого ученика) по всем предметам

/v2.0/edu-group/{group}/subject/{subject}/criteria-marks-totals - get_final_group_marks_by_subject(group_id: int, subject_id: int) - Метод, позволяющий получить итоговые оценки всего класса по указанному предмету

/v2.0/edu-group/{group}/criteriajournalsection/{section}/criteria-marks - func - Метод полученипя списка суммативных оценок класса за конкретную тему (СОр или СОч по section_id параметру, который является связывающим звеном для оценок одной темы)

/v2.0/edu-group/{group}/criteriajournalsection/{section}/criteria-marks-totals - func - Метод полученипя списка итоговых суммативных оценок класса за конкретную тему (СОр или СОч по section_id параметру, который является связывающим звеном для сумативной оценки за четверть)

/v2.0/users/{user}/school-memberships - get_user_memberships(user_id: int) - Список участий в школах для произвольного пользователя

/v2.0/users/{user}/education - get_user_education(user_id: int) - Список участий в школах для произвольного пользователя

/v2.0/persons/{person}/school-memberships - get_person_memberships(person_id: int) - Список участий в школах для произвольной персоны

/v2.0/users/me/schools - get_schools() - Список идентификаторов школ текущего пользователя

/v2.0/users/{user}/schools - get_user_schools(user_id: int) - Список идентификаторов школ произвольного пользователя

/v2.0/users/me/edu-groups - get_edu_groups() - Список идентификаторов классов текущего пользователя

/v2.0/users/{user}/edu-groups - get_user_edu_groups(user_id: int) - Список идентификаторов классов текущего пользователя

/v2.0/users/me/school-memberships - get_memberships() - Список участий в школах для текущего пользователя

/v2.0/edu-groups/{eduGroup} - get_group_info(edu_group_id: int) - Класс или учебная группа

/v2.0/edu-groups - get_groups_info(edu_groups_list: list) - Список учебных групп

/v2.0/schools/{school}/edu-groups - get_school_groups(school_id: int) - Список классов в школе

/v2.0/persons/{person}/edu-groups - get_person_groups(person_id: int) - Учебные группы персоны

/v2.0/persons/{person}/edu-groups/all - get_person_groups_all(person_id: int) - 123

/v2.0/persons/{person}/schools/{school}/edu-groups - get_person_school_groups(person_id: int, school_id: int) - Учебные группы персоны в школе

/v2.0/edu-groups/{group}/persons - get_groups_pupils(edu_group_id: int) - Список учеников учебной группы

/v2.0/edu-groups/students - get_students_groups_list() - Список групп с учениками

/v2.0/edu-groups/{groupId}/parallel - get_groups_parallel(group_id: int) - Список параллельных групп(включая группу указанную в параметрах)

/authorizations/esia/v2.0/users/linked - func - 123

/authorizations/esia/v2.0 - func - 123

/v2.0/files/async/upload - func - Метод загрузки файла. Файл будет загружен в первую папку привязанной к приложению сети. При загрузке файла обязательно надо передать заголовки Content-Type: multipart/form-data с соотвествующим boundary и верный Content-Length.

/v2.0/folder/{folderId}/files/async/upload - func - Метод для загрузки файла в папку. При загрузке файла обязательно надо передать заголовки Content-Type: multipart/form-data с соотвествующим boundary и верный Content-Length.

/v2.0/files/async/upload/base64 - func - Метод загрузки файла в формате строки base64. При загрузке файла обязательно надо передать заголовки Content-Type: application/json, а бинарные данные файла передать в теле запроса. Файл будет загружен в первую папку привязанной к приложению сети.

/v2.0/files/async/upload/{taskId} - func - Метод получения загруженного файла.

/v2.0/files/{fileId}/repost - func - Репост файла

/v2.0/folder/{folderId}/files - func - Получение файлов в папке

/v2.0/apps/current/files - func - Получение файлов приложения

/v2.0/files/{fileId}/like - func - Увеличения количества лайков/голосов на единицу

/v2.0/edu-groups/{group}/final-marks - get_group_marks(group_id: int) - Оценки в учебной группе

/v2.0/persons/{person}/edu-groups/{group}/final-marks - get_person_group_marks(person_id: int, group_id: int) - Оценки персоны в учебной группе

/v2.0/persons/{person}/edu-groups/{group}/allfinalmarks - get_person_group_marks_final(person_id: int, group_id: int) - Итоговые оценки персоны в учебной группе

/v2.0/edu-groups/{group}/subjects/{subject}/final-marks - get_group_subject_final_marks(group_id: int, subject_id: int) - Оценки по предмету в учебной группе

/v2.0/users/me/friends - get_friends() - Список id пользователей друзей текущего пользователя

/v2.0/users/{user}/friends - get_user_friends(user_id: int) - Список id пользователей друзей конкретного пользователя по его id

/v2.0/users/me/school/{school}/homeworks - def get_school_homework(school_id: int, start_time: datetime.datetime, end_time: datetime.datetime): - Получить домашние задания пользователя за период времени

/v2.0/users/me/school/homeworks - get_homework_by_id(homework_id: int) - Получить домашние задания по идентификаторам

/v2.0/persons/{person}/school/{school}/homeworks - get_person_homework(school_id: int,person_id: int, start_time: datetime.datetime, end_time: datetime.datetime): - Получить домашние задания обучающегося за период времени

/v2.0/works/{workId}/test - func - Прикрепить тест к дз

/v2.0/lessons/{lesson}/log-entries - delete_lesson_log(lesson_id: int, person_id: int) - Список отметок о посещаемости на уроке

/v2.0/lesson-log-entries - get_lesson_logs(lessons_ids: list) - Список отметок о посещаемости на нескольких уроках

/v2.0/lesson-log-entries/lesson/{lesson}/person/{person} - get_person_lesson_log(person_id: int, lesson_id: int) - Отметка о посещаемости ученика на уроке

/v2.0/lesson-log-entries/group/{eduGroup} - get_group_lesson_log(group_id: int, subject_id: int, start_time: datetime.datetime, end_time: datetime.datetime) - Список отметок о посещаемости на уроках по заданному предмету в классе за интервал времени

/v2.0/lesson-log-entries/person/{personID}/subject/{subjectID} - func - Список отметок о посещаемости обучающегося по предмету за интервал времени

/v2.0/lesson-log-entries/person={personID}&subject={subjectID}&from={from}&to={to} - get_person_subject_lesson_log(person_id: int,subject_id: int,start_time: datetime.datetime,end_time: datetime.datetime) - Список отметок о посещаемости обучающегося по предмету за интервал времени

/v2.0/persons/{person}/lesson-log-entries - get_person_lesson_logs(person_id: int, start_time: datetime.datetime, end_time: datetime.datetime) - Список отметок о посещаемости обучающегося за интервал времени

/v2.0/lesson-log-entries/statuses - get_lesson_log_statuses() - Получить список возможных отметок о посещаемости. Пример ответа - ["Attend","Absent","Ill","Late","Pass"].

/v2.0/lessons/{lesson} - get_lesson_info(lesson_id: int) - Получить урок с заданным id

/v2.0/lessons/many - get_many_lessons_info(lessons_list: list) - Получение списка уроков по списку id

/v2.0/edu-groups/{group}/lessons/{from}/{to} - get_group_lessons_info(group_id: int, start_time: datetime.datetime, end_time: datetime.datetime) - Уроки группы за период

/v2.0/edu-groups/{group}/subjects/{subject}/lessons/{from}/{to} - get_group_lessons_info(group_id: int, start_time: datetime.datetime, end_time: datetime.datetime) - Уроки группы по предмету за период

/v2.0/works/{workID}/marks/histogram - get_marks_histogram(work_id: int) - Получение деперсонализированной гистограмы оценок всего класса по идентификатору работы

/v2.0/periods/{periodID}/subjects/{subjectID}/groups/{groupID}/marks/histogram - get_subject_marks_histogram(group_id: int, period_id: int, subject_id: int) - Получение деперсонализированной гистограмы оценок всего класса за отчетный период

/v2.0/marks/{mark} - get_mark_by_id(mark_id: int) - Оценка

/v2.0/works/{work}/marks - get_marks_by_work(work_id: int) - Список оценок за работу на уроке

/v2.0/lessons/{lesson}/marks - get_marks_by_lesson(lesson_id: int) - Оценки на уроке

/v2.0/lessons/marks - get_marks_by_lessons(lessons_ids: list) - Список оценок за несколько уроков

/v2.0/lessons/many/marks - func - Список оценок за несколько уроков

/v2.0/edu-groups/{group}/marks/{from}/{to} - get_group_marks_period(group_id: int,start_time: datetime.datetime, end_time: datetime.datetime) - Оценки учебной группы за период

/v2.0/edu-groups/{group}/subjects/{subject}/marks/{from}/{to} - get_group_subject_marks(group_id: int, subject_id: int, start_time: datetime.datetime, end_time: datetime.datetime) - Оценки учебной группы по предмету за период

/v2.0/persons/{person}/schools/{school}/marks/{from}/{to} - get_person_marks(person_id: int, school_id: int, start_time: datetime.datetime, end_time: datetime.datetime) - Оценки персоны в школе за период

/v2.0/persons/{person}/edu-groups/{group}/marks/{from}/{to} - func - Оценки персоны в учебной группе за период

/v2.0/persons/{person}/lessons/{lesson}/marks - get_person_lessons_marks(person_id: int, lesson_id: int) - Оценки персоны за урок

/v2.0/persons/{person}/works/{work}/marks - get_person_work_marks(person_id: int, work_id: int) - Оценки персоны за работу

/v2.0/persons/{person}/subjects/{subject}/marks/{from}/{to} - get_person_subject_marks(person_id: int, subject_id: int, start_time: datetime.datetime, end_time: datetime.datetime) - Оценки персоны по предмету за период

/v2.0/persons/{person}/subject-groups/{subjectgroup}/marks/{from}/{to} - func - Оценки персоны по предмету за период

/v2.0/lessons/{date}/persons/{person}/marks - func - Оценки персоны по дате урока

/v2.0/persons/{person}/marks/{date} - get_marks_by_date(person_id: int, date: datetime.datetime) - Оценки персоны по дате выставления оценки

/v2.0/persons/{personId}/works/{workId}/mark - get_person_work_marks(person_id: int, work_id: int) - Выставить оценку ученику по работе

/v2.0/marks/values - get_marks_values() - Метод возвращает все поддерживаемые системы (типы) оценок и все возможные оценки в каждой из систем.

/v2.0/marks/values/type/{type} - get_marks_values_by_type(marks_type: str) - Метод возвращает все возможные оценки в запрашиваемой системе (типе) оценок. Чтобы узнать, какие типы поддерживаются нужно предварительно делать запрос marks/values без параметров.

TODO: доделать методы
/v2.0/persons - func - Список учеников в классе или учебной группе

/v2.0/edu-groups/{eduGroup}/students - func - Список учеников в классе или учебной группе

/v2.0/persons/search - func - 123

/v2.0/persons/{person} - func - Профиль персоны

/v2.0/persons/{person}/group/{group}/recentmarks - func - Последние оценки/отметки посещаемости персоны по предмету, указанному в параметре subject, начиная с даты определенном в параметре fromDate и с ограничением на выводимое количество указанном в параметре limit

/authorizations/esia/v2.0/regions - func - 123

/v2.0/edu-groups/{eduGroup}/reporting-periods - func - Список отчётных периодов для класса или учебной группы

/v2.0/edu-groups/{eduGroup}/reporting-period-group - func - Группа отчетных периодов для класса или учебной группы

/v2.0/persons/{person}/groups/{group}/schedules - func - Расписание ученика

/v2.0/school-rating/from/{from}/to/{to} - func - ѕолучение списка школ с наивысшим рейтингом за выбранный период

/v2.0/school-rating/from/{from}/to/{to}/new - func - ѕолучение списка новых школ с наивысшим рейтингом за выбранный период

/v2.0/schools/{school} - func - Профиль школы

/v2.0/schools - func - Список профилей нескольких школ (или список образовательных организаций пользователя, если не передано ни одного идентификатора школы)

/v2.0/schools/person-schools - func - Список образовательных организаций пользователя

/v2.0/schools/cities - func - Список населенных пунктов, образовательные организации которых включены в Систему

/v2.0/schools/search/by-oktmo - func - 123

/v2.0/schools/{school}/parameters - func - Параметры общеобразовательных организаций

/v2.0/events/{id}/invite - func - Пригласить в событие

/v2.0/groups/{id}/invite - func - Пригласить в группу

/v2.0/networks/{id}/invite - func - Пригласить в сеть

/v2.0/edu-groups/{eduGroup}/subjects - func - Список предметов, преподаваемых в классе в текущем отчётном периоде

/v2.0/schools/{school}/subjects - func - Список предметов, преподаваемых в образовательной организации в текущем учебном году

/v2.0/tasks/{task} - func - Домашнее задание

/v2.0/tasks - func - Домашние задания за несколько уроков

/v2.0/lessons/{lesson}/tasks - func - Список домашних заданий за урок

/v2.0/works/{work}/tasks - func - Список домашних заданий

/v2.0/persons/{person}/tasks - func - Список домашних заданий ученика по предмету

/v2.0/tasks/{personId}/undone - func - Список невыполненных домашних заданий обучающегося с истёкшим сроком выполнения

/v2.0/teacher/{teacher}/students - func - Список учеников для учителя который ведет уроки у этих учеников(они должны быть в расписании) от недели назад и на 30 дней вперед

/v2.0/schools/{school}/teachers - func - Список преподавателей в выбранной образовательной организации

/v2.0/edu-groups/{group}/teachers - func - Список учителей, которые ведут уроки в данной группе, учитываются уроки от недели назад и на 30 дней вперед

/v2.0/thematic-marks/{mark} - func - Получить оценку с заданным id

/v2.0/thematic-marks - func - Сохранить оценку

/v2.0/persons/{person}/edu-groups/{group}/subjects/{subject}/thematic-marks/{from}/{to} - func - Оценки персоны по предмету в учебной группе за период

/v2.0/persons/{person}/edu-groups/{group}/thematic-marks/{from}/{to} - func - Оценки персоны в учебной группе за период

/v2.0/persons/{person}/schools/{school}/thematic-marks/{from}/{to} - func - Оценки персоны в школе за период

/v2.0/edu-groups/{group}/subjects/{subject}/thematic-marks - func - Оценки в учебной группе по предмету

/v2.0/schools/{school}/timetables - func - Получение расписания школы

/v2.0/edu-groups/{eduGroup}/timetables - func - Получение расписания учебной группы

/v2.0/users/me/feed - func - Лента пользователя

/v2.0/users/{user}/groups - func - Список идентификаторов групп пользователя

/v2.0/users/me/children - func - Список id пользователей детей текущего пользователя

/v2.0/users/{user}/relatives - func - Получение всех родственных связей произвольного пользователя.

/v2.0/users/me/relatives - func - Получение всех родственных связей текущего пользователя.

/v2.0/users/me/childrenrelatives - func - Список id всех родственных связей детей произвольного пользователя

/v2.0/users/{user} - func - Профиль произвольного пользователя. Профиль текущего пользователя можно получить по users/me

/v2.0/users/me - func - Профиль текущего пользователя.

/v2.0/users/me/roles - func - Роли текущего пользователя.

/v2.0/users/many - func - Профили нескольких пользователей

/v2.0/users - func - Профили нескольких пользователей

/v2.0/users/{user}/roles - func - Роли пользователя

/v2.0/users/{user}/wallrecord - func - Отправить сообщение с изображением на стену пользователя

/v2.0/edu-groups/{group}/wa-marks/{from}/{to} - func - Средние взвешенные оценки учебной группы за период

/v2.0/works - func - Список работ на уроке

/v2.0/lessons/{lesson}/works - func - Список работ на уроке

/v2.0/works/{work} - func - Работа на уроке

/v2.0/works/many - func - Получение списка работ по списку id

/v2.0/works/{work}/persons/{person}/status - func - Изменить статус выполнения домашней работы учащимся.

/v2.0/work-types/{school} - func - Получение списка всех типов работ школы