Методы

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&asManager=true

contest.list

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

Параметр Описание
gym Boolean. Если имеет значение true, то возвращаются соревнования из Тренировок. Иначе, возвращаются обычные соревнования.

Возвращаемое значение: Возвращает список объектов 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

Возвращает описание соревнование и запрошенную часть результатов.

Параметр Описание
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&asManager=true&from=1&count=5&showUnofficial=true

contest.status

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

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

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

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

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

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 Количество возвращаемых попыток.

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

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