auth
login—Login: Get an access token
input
CredentialsInoutput
CredentialsOutlogout—Logout: Discard access token
misc
getFortune—Get a fortune message
output
string
getTime—Get server time
output
TimegetHomepageStats—Get homepage stats
output
HomepageStatsgetLogo—Get Jutge.org logo as a PNG file
tables
getLanguages—Returns all languages
Returns all languages as a dictionary of objects, indexed by id.
output
LanguagesgetCountries—Returns all countries
Returns all countries as a dictionary of objects, indexed by id.
output
CountriesgetCompilers—Returns all compilers
Returns all compilers as a dictionary of objects, indexed by id.
output
CompilersgetDrivers—Returns all drivers
Returns all drivers as a dictionary of objects, indexed by id.
output
DriversgetVerdicts—Returns all verdicts
Returns all verdicts as a dictionary of objects, indexed by id.
output
VerdictsgetProglangs—Returns all proglangs
Returns all proglangs as a dictionary of objects, indexed by id.
output
ProglangsgetAll—Returns all tables
Returns all compilers, countries, drivers, languages, proglangs, and verdicts in a single request. This data does not change often, so you should only request it once per session.
output
Tablesproblems
getAllAbstractProblems—Get all available abstract problems
Includes problems.
output
AbstractProblemsgetAbstractProblems—Get available abstract problems whose keys are in `problem_nms` (comma separated list)
Includes problems.
input
string
output
AbstractProblemsgetAbstractProblemsInList—Get available abstract problems that belong to a list
Includes problems.
input
string
output
AbstractProblemsgetAbstractProblem—Get an abstract problem
Includes owner and problems
input
string
output
AbstractProblemgetAbstractProblemExtras—Get extras of an abstract problem
Includes accepted compilers and accepted proglangs
input
string
output
AbstractProblemExtrasgetProblem—Get a problem
Includes abstract problem, which includes owner
input
string
output
ProblemgetProblemExtras—Get extras of a problem.
Includes accepted compilers, accepted proglangs, official solutions checks and handler specifications
input
string
output
ProblemExtrasgetSampleTestcases—Get sample testcases of a problem.
input
string
output
TestcasesgetPublicTestcases—Get public testcases of a problem.
Public testcases are like sample testcases, but are not meant to be show in the problem statatement, because of their long length.
input
string
output
TestcasesgetHtmlStatement—Get Html statement of a problem.
Currently, this is suboptimal, but I already know how to improve it.
input
string
output
string
getTextStatement—Get Text statement of a problem.
input
string
output
string
getMarkdownStatement—Get Markdown statement of a problem.
input
string
output
string
getPdfStatement—Get PDF statement of a problem.
input
string
getZipStatement—Get ZIP archive of a problem.
input
string
student
student.keys
getAll—Get problem, courses (enrolled and available) and list keys.
output
AllKeysgetProblems—Get problem keys.
output
Array of
string
getEnrolledCourses—Get enrolled course keys.
output
Array of
string
getAvailableCourses—Get available course keys.
output
Array of
string
getLists—Get list keys.
output
Array of
string
student.profile
get—Get the profile.
output
Profileupdate—Update the profile
input
NewProfilegetAvatar—Returns the avatar as a PNG file.
setAvatar—Set a PNG file as avatar
changePassword—Change password
Receives the old password and the new one, and changes the password if the old one is correct
input
PasswordUpdatestudent.dashboard
getAllDistributions—Get all distributions
output
DistributionsgetCompilersDistribution—Get compilers distribution
output
DistributiongetDashboard—Get dashboard
output
DashboardgetHeatmapCalendar—Get heatmap calendar of submissions
output
HeatmapCalendargetProglangsDistribution—Get programming languages distribution
output
DistributiongetStats—Get dashboard stats
output
DashboardStatsgetSubmissionsByHour—Get submissions by hour distribution
output
DistributiongetSubmissionsByWeekDay—Get submissions by weekday distribution
output
DistributiongetVerdictsDistribution—Get verdicts distribution
output
Distributionstudent.submissions
getAll—Get all submissions.
Flat array of submissions in chronological order.
output
SubmissionsgetForAbstractProblem—Get all submissions for an abstract problem.
Grouped by problem.
input
string
output
DictDictSubmissionsgetForProblem—Get all submissions for a problem.
input
string
output
DictSubmissionsget—Get a submission.
input
problem_id–string
submission_id–string
output
Submissionsubmit—Perform a submission.
input
problem_id–string
compiler_id–string
annotation–string
output
SubmissionPostOutstudent.courses
getAllAvailable—Get all available courses.
output
BriefCoursesgetAllEnrolled—Get all enrolled courses.
output
BriefCoursesgetAvailable—Get an available course.
Includes owner and lists.
input
string
output
CoursegetEnrolled—Get an enrolled course.
Includes owner and lists.
input
string
output
Courseenroll—Enroll in an available course.
input
string
unenroll—Unenroll from an enrolled course.
input
string
student.lists
getAll—Get all lists.
output
BriefListsget—Get a list.
Includes items, owner.
input
string
output
Liststudent.statuses
getAll—Get statuses for all problems.
output
AbstractStatusesgetForAbstractProblem—Get status for an abstract problem.
input
string
output
AbstractStatusgetForProblem—Get status for a problem.
input
string
output
Statusstudent.awards
getAll—Get all awards.
output
BriefAwardsget—Get an award.
input
string
output
Awardinstructor
instructor.documents
index—Get index of all documents
output
Documentsget—Get a document (without PDF)
input
string
output
DocumentgetPdf—Get PDF of a document
input
string
create—Create a new document
input
Documentupdate—Update a document (without PDF)
input
DocumentupdatePdf—Update PDF of a document
input
string
remove—Remove a document (including PDF)
input
string
instructor.lists
index—Get index of all lists
output
InstructorListsget—Get a list with its items
input
string
output
InstructorListWithItemsgetItems—Get the items of a list
input
string
output
InstructorListItemscreate—Create a new list
input
InstructorListupdate—Update an existing list
input
InstructorListremove—Delete an existing list
input
string
setItems—Set the items of a list
input
list_nm–string
items–InstructorListItemsinstructor.courses
index—Get index of all courses
output
InstructorCoursesget—Get a course with its items (lists, courses and tutors)
input
string
output
InstructorCourseWithItemsgetLists—Get lists of a course
input
string
output
Array of
string
getStudents—Get students of a course
input
string
output
CourseMembersgetTutors—Get tutors of a course
input
string
output
CourseMemberscreate—Create a new course
input
InstructorCourseupdate—Update an existing course
input
InstructorCourseremove—Delete an existing course
Note: A course should not be deleted. Ask a system administrator to remove it.
input
string
set_lists—Set lists of a course
input
course_nm–string
lists–Array of
string
invite_students—Invite students to a course
input
course_nm–string
emails–Array of
string
invite_tutors—Invite tutors to a course
input
course_nm–string
emails–Array of
string
remove_students—Remove students from a course
input
course_nm–string
emails–Array of
string
remove_tutors—Remove tutors from a course
input
course_nm–string
emails–Array of
string
instructor.exams
index—Get index of all exams
output
InstructorExamsget—Get an exam with its items (course, problems, documents, students)
input
string
output
InstructorExamWithItemscreate—Create a new exam
input
InstructorExamCreationupdate—Update an existing exam
input
InstructorExamCreationremove—Delete an existing exam
Note: An exam can only be deleted if it has not started.
input
string
getDocuments—Get documents of an exam
input
string
output
InstructorExamDocumentsgetCourse—Get course of an exam
input
string
output
InstructorExamCoursegetProblems—Get problems of an exam
input
string
output
InstructorExamProblemsgetStudents—Get students of an exam
input
string
output
InstructorExamStudentsgetStudent—Get an student of an exam
input
exam_nm–string
email–string
output
InstructorExamStudentgetSubmissions—Get submissions of an exam
This endpoint prepares a ZIP file to download the submissions of an exam. Preparing the ZIP file takes some time, an href link to the ZIP will be returned. This ZIP file will be available for download for a limited time.
input
exam_nm–string
options–InstructorExamSubmissionsOptionsoutput
PacksetDocuments—Set documents of an exam
input
exam_nm–string
document_nms–Array of
string
setProblems—Set problems of an exam
input
exam_nm–string
problems–InstructorExamProblemssetStudents—Set students of an exam
input
exam_nm–string
students–InstructorExamStudentsPostaddStudents—Add students to an exam
input
exam_nm–string
students–InstructorExamStudentsPostremoveStudents—Remove students from an exam
input
exam_nm–string
emails–Array of
string
instructor.queries
ricard01—The old and venerable ricard01 query. 😀
Returns a list of submissions for a given problem for all students of a given course. Each submission includes the email, time, problem name, problem id, verdict, and IP address. The list is ordered by email and time.
input
course_nm–string
problem_nm–string
output
SubmissionsQueryricard02—The old and venerable ricard02 query. 😀
Returns a list of submissions for all problems in a given list for all students of a given course. Each submission includes the email, time, problem name, problem id, verdict, and IP address. The list is ordered by email, problem id and time.
input
course_nm–string
list_nm–string
output
SubmissionsQueryinstructor.problems
getPasscode—Get the passcode of a problem.
Returns an empty string if the problem has no passcode.
input
string
output
string
setPasscode—Set or update the passcode of a problem.
The passcode must be at least 8 characters long and contain only alphanumeric characters. The passcode will be stored in the database in plain text.
input
problem_nm–string
passcode–string
removePasscode—Remove passcode of a problem.
input
string
deprecate—Deprecate a problem.
input
problem_nm–string
reason–string
undeprecate—Undeprecate a problem.
input
string
download—Download a problem.
Quick and dirty implementation, should be improved. Returns a zip file with the abstract problem and all its problems.
input
string
admin
admin.users
count—Count users
output
number
create—Create a user
input
UserCreationremove—Remove a user
input
string
setPassword—Set a password for a user
input
email–string
password–string
admin.tasks
purge-auth-tokens—Purge expired access tokens
Purge expired access tokens (call it from time to time, it does not hurt)
clear-caches—Clear all memoization caches
admin.stats
getCounters—Get counters
output
DistributiongetDistributionOfVerdicts—Get distribution of verdicts
output
DistributiongetDistributionOfVerdictsByYear—Get distribution of verdicts by year
output
DistributiongetDistributionOfCompilers—Get distribution of compilers
output
DistributiongetDistributionOfProglangs—Get distribution of proglangs
output
DistributiongetDistributionOfUsersByYear—Get distribution of registered users by year
output
DistributiongetDistributionOfUsersByCountry—Get distribution of registered users by country
output
DistributiongetDistributionOfUsersBySubmissions—Get distribution of registered users by submissions using a custom bucket size
input
integer
output
DistributiongetRankingOfUsers—Get ranking of users
input
string
number
output
UserRankinggetDistributionOfSubmissionsByHour—Get distribution of submissions by hour
output
DistributiongetDistributionOfSubmissionsByProglang—Get distribution of submissions by proglang
output
DistributiongetDistributionOfSubmissionsByCompiler—Get distribution of submissions by compiler
output
DistributiongetDistributionOfSubmissionsByWeekday—Get distribution of submissions by weekday
output
DistributiongetDistributionOfSubmissionsByYear—Get distribution of submissions by year
output
DistributiongetDistributionOfSubmissionsByYearForProglang—Get distribution of submissions by year for a proglang
input
string
output
DistributiongetDistributionOfSubmissionsByDay—Get distribution of submissions by day
output
DistributiongetHeatmapCalendarOfSubmissions—Get heatmap calendar of submissions
Data is provided as required by https://cal-heatmap.com
output
HeatmapCalendargetUpcomingExams—Get upcoming exams
output
UpcomingExamsadmin.problems
getProblemSolution—Get official solution for a problem for a proglang
input
problem_id–string
proglang–string
output
string
check
checkUser—Checks that query actor is a user
checkInstructor—Checks that query actor is an instructor
checkAdmin—Checks that query actor is an admin
throwError—Throw an exception of the given type
input
string
playground
upload—Upload a file
input
Nameoutput
string
negate—Get negative of an image
download—Download a file
input
Namedownload2—Download a file with a string
input
Nameoutput
string
ping—Ping the server to get a pong string
output
string
toUpperCase—Returns the given string in uppercase
input
string
output
string
add2i—Returns the sum of two integers
input
TwoIntsoutput
integer
add2f—Returns the sum of two floats
input
TwoFloatsoutput
number
inc—increment two numbers
input
TwoIntsoutput
TwoIntsadd3i—Returns the sum of three integers
input
a–integer
b–integer
c–integer
output
integer