Методы

blogEntry.comments

Возвращает список комментариев к заданной записи в блоге.

Параметр Описание
blogEntryId (Обязательный) Id записи в блоге. Его можно увидеть в URL записи. Например: /blog/entry/79

Возвращаемое значение: Список объектов Comment.

Пример: https://mirror.codeforces.com/api/blogEntry.comments?blogEntryId=79

blogEntry.view

Возвращает запись в блоге.

Параметр Описание
blogEntryId (Обязательный) Id записи в блоге. Его можно увидеть в URL записи. Например: /blog/entry/79

Возвращаемое значение: Возвращает объект BlogEntry в полном виде.

Пример: https://mirror.codeforces.com/api/blogEntry.view?blogEntryId=79

contest.hacks

Возвращает список взломов в указанном соревновании. Полный список взломов становится доступен через определенное время после конца соревнования. Во время соревнования пользователю доступны только взломы, сделанные им или против него.

Параметр Описание
contestId (Обязательный) Id соревнования. Это не номер раунда. Его можно увидеть в URL соревнования. Например: /contest/566/status
asManager Boolean. Если имеет значение true, то ответ будет содержать информацию, доступную для менеджеров соревнования. Иначе, ответ будет содержать только информацию, доступную участникам. Для использования необходимо быть менеджером соревнования.

Возвращаемое значение: Возвращает список объектов Hack.

Пример: https://mirror.codeforces.com/api/contest.hacks?contestId=566

contest.list

Возвращает информацию о всех доступных соревнованиях.

Параметр Описание
gym Boolean. Если имеет значение true, то возвращаются соревнования из Тренировок. Иначе, возвращаются обычные соревнования.
groupCode Код группы (например, sfSJn5pz1a) используется для фильтрации соревнований. Вам необходимо использовать аккаунт, который имеет как минимум доступ на чтение к этой группе.

Возвращаемое значение: Возвращает список объектов Contest. Если этот метод вызывается не анонимно, то будут возвращены все доступные вызывающему пользователю соревнования, включая мэшапы и приватные тренировки.

Пример: https://mirror.codeforces.com/api/contest.list?gym=true

contest.ratingChanges

Возвращает изменения рейтинга после контеста.

Параметр Описание
contestId (Обязательный) Id соревнования. Это не номер раунда. Его можно увидеть в URL соревнования. Например: /contest/566/status

Возвращаемое значение: Возвращает cписок объектов RatingChange.

Пример: https://mirror.codeforces.com/api/contest.ratingChanges?contestId=566

contest.standings

Возвращает описание соревнования и таблицу результатов.

Для соревнований типа gym и mashup этот метод доступен только через аутентифицированный API-запрос от пользователя, который может просматривать это соревнование. Необязательные параметры можно использовать для постраничного вывода или фильтрации возвращаемой таблицы результатов.

Для обычных соревнований обычные и анонимные пользователи могут запрашивать таблицу результатов только у публичных соревнований, и только анонимным GET-запросом ровно с одним query-параметром: contestId. Используйте https://mirror.codeforces.com/api/contest.standings?contestId=<id>.

В этом режиме для обычных соревнований ответ содержит только полную официальную публичную таблицу результатов. Не указывайте from, count, handles, room, showUnofficial, participantTypes, параметры API-аутентификации или любые другие параметры. Непубличные обычные соревнования и обычные соревнования со скрытой таблицей результатов недоступны в этом публичном режиме.

Параметр Описание
contestId (Обязательный) Id соревнования. Это не номер раунда. Его можно увидеть в URL соревнования. Например: /contest/566/status
asManager Boolean. Если имеет значение true, то ответ будет содержать информацию, доступную для менеджеров соревнования. Иначе, ответ будет содержать только информацию, доступную участникам. Для использования необходимо быть менеджером соревнования.
from Индекс (начиная с 1) первой возвращаемой строки результатов.
count Количество возвращаемых строк результатов.
handles Список хэндлов, разделенных точкой с запятой. Можно передать до 10000 хэндлов.
room Если указан, то только участники из указанной комнаты будут возвращены.
showUnofficial Если имеет значение true, то все участники (виртуальные, вне конкурса) будут возвращены. Иначе, только официальные участники соревнования будут возвращены.
participantTypes Список типов участников через запятую без пробелов. Возможные значения: CONTESTANT, PRACTICE, VIRTUAL, MANAGER, OUT_OF_COMPETITION. Будут отображены только участники с указанными типами.

Возвращаемое значение: Возвращает объект с тремя полями: "contest", "problems" and "rows". Поле "contest" содержит объект Contest. Поле "problems" содержит список объектов Problem. Поле "rows" содержит список объектов RanklistRow.

Пример: https://mirror.codeforces.com/api/contest.standings?contestId=566

contest.status

Возвращает попытки для указанного соревнования. Дополнительно может вернуть попытки указанного пользователя.

Параметр Описание
contestId (Обязательный) Id соревнования. Это не номер раунда. Его можно увидеть в URL соревнования. Например: /contest/566/status
asManager Boolean. Если имеет значение true, то ответ будет содержать информацию, доступную для менеджеров соревнования. Иначе, ответ будет содержать только информацию, доступную участникам. Для использования необходимо быть менеджером соревнования.
handle Хэндл пользователя Codeforces.
from Индекс (начиная с 1) первой возвращаемой попытки.
count Количество возвращаемых попыток.
includeSources Определяет, следует ли включать исходные коды в вывод. Опция доступна только при использовании asManager и наличии у пользователя прав менеджера на контест.

Возвращаемое значение: Возвращает список объектов Submission, отсортированных по убыванию id попытки.

Пример: https://mirror.codeforces.com/api/contest.status?contestId=566&from=1&count=10

group.isManager

Возвращает, являются ли указанные пользователи менеджерами заданной группы. Этот метод доступен только авторизованным пользователям API.

Параметр Описание
groupCode (Обязательный) Код группы.
handles (Обязательный) Список хэндлов, разделенных точкой с запятой. Можно передать до 10000 хэндлов.

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

Пример: https://mirror.codeforces.com/api/group.isManager?groupCode=JMRDZdAtYr&handles=MikeMirzayanov;tourist

problemset.problems

Возвращает все задачи из архива. Задачи можно фильтровать по тегам

Параметр Описание
tags Список тегов, разделенных точкой с запятой.
problemsetName Короткое имя дополнительного архива, например 'acmsguru'

Возвращаемое значение: Возвращает два списка. Список объектов Problem и список объектов ProblemStatistics.

Пример: https://mirror.codeforces.com/api/problemset.problems?tags=implementation

problemset.recentStatus

Возвращает недавние посылки.

Параметр Описание
count (Обязательный) Количество возвращаемых посылок. Может быть не более 1000.
problemsetName Короткое имя дополнительного архива, например 'acmsguru'

Возвращаемое значение: Возвращает список объектов Submission, отсортированных по убыванию id посылки.

Пример: https://mirror.codeforces.com/api/problemset.recentStatus?count=10

recentActions

Возвращает прямой эфир

Параметр Описание
maxCount (Обязательный) Количество возвращаемых действий. Может быть не более 100.

Возвращаемое значение: Возвращает список объектов RecentAction.

Пример: https://mirror.codeforces.com/api/recentActions?maxCount=30

system.status

Метод system.status обеспечивает проверку работоспособности (Health Check) основной инфраструктуры и конвейера обработки системы в реальном времени. Он возвращает текущий статус доступности внутренних сервисов и ключевые метрики производительности (пропускную способность) за последние 5 минут.

Параметр Описание

Возвращаемое значение: Возвращает JSON-объект, отражающий текущий статус работоспособности основных компонентов инфраструктуры и метрики пропускной способности системы за последние 5 минут.

Пример: https://mirror.codeforces.com/api/system.status

user.blogEntries

Возвращает список записей в блоге заданного пользователя.

Параметр Описание
handle (Обязательный) Хэндл пользователя Codeforces.

Возвращаемое значение: Список объектов BlogEntry в кратком виде.

Пример: https://mirror.codeforces.com/api/user.blogEntries?handle=Fefer_Ivan

user.friends

Возвращает друзей авторизованного пользователя. Для использования этого метода необходима авторизация.

Параметр Описание
onlyOnline Boolean. Если имеет значение true, то возвращаются только те друзья, которые сейчас на сайте. Иначе, возвращаются все друзья.

Возвращаемое значение: Возвращает список строк — хэндлы пользователей.

Пример: https://mirror.codeforces.com/api/user.friends?onlyOnline=true

user.info

Возвращает информацию об одном или нескольких пользователях.

Параметр Описание
handles (Обязательный) Список хэндлов, разделенных точкой с запятой. Можно передать до 10000 хэндлов.
checkHistoricHandles Boolean, по умолчанию значение равно true. Если включен этот флажок, то использовать историю смен хэндлов при поиске пользователя.

Возвращаемое значение: Возвращает список объектов User по запрошенным хэндлам, в том же порядке что и в параметрах.

Пример: https://mirror.codeforces.com/api/user.info?handles=DmitriyH;Fefer_Ivan&checkHistoricHandles=false

user.ratedList

Возвращает список пользователей, участвовавших в хотя бы одном рейтинговом соревновании.

Параметр Описание
activeOnly Boolean. Если true, то возвращаются только те пользователи, которые принимали участие в рейтинговых соревнованиях Codeforces за последний месяц. Иначе, возвращаются все пользователи, участвовавшие в хотя бы одном рейтинговом соревновании.
includeRetired Boolean. Если true, метод возвращает всех рейтинговых пользователей, иначе метод возвращает только пользователей, которые были онлайн в течение месяца.
contestId Id соревнования. Это не номер раунда. Его можно увидеть в URL соревнования. Например: /contest/566/status

Возвращаемое значение: Возвращает список объектов User, отсортированных по убыванию рейтинга.

Пример: https://mirror.codeforces.com/api/user.ratedList?activeOnly=true&includeRetired=false

user.rating

Возвращает историю рейтинга указанного пользователя.

Параметр Описание
handle (Обязательный) Хэндл пользователя Codeforces.

Возвращаемое значение: Возвращает список объектов RatingChange для указанного пользователя.

Пример: https://mirror.codeforces.com/api/user.rating?handle=Fefer_Ivan

user.status

Возвращает попытки указанного пользователя.

Параметр Описание
handle (Обязательный) Хэндл пользователя Codeforces.
from Индекс (начиная с 1) первой возвращаемой попытки.
count Количество возвращаемых попыток.
includeSources Определяет, следует ли включать исходные коды в вывод. Опция доступна только при использовании для собственного аккаунта.

Возвращаемое значение: Возвращает список объектов Submission, отсортированных по убыванию id попытки.

Пример: https://mirror.codeforces.com/api/user.status?handle=Fefer_Ivan&from=1&count=10