Problem

General information about problems in AIForces in represented in Problemsetting, here only API endpoints are described.

Endpoints

[GET] /problems

Retrieve general information of the problems.

Returns

list of Problem objects.

Arguments

Argument	Format	Default	Description
show_private	boolean	false	If set to true by non-admin, Forbidden error is returned. Admins can view all the problems.
fields	list of strings	All fields	Fields, which will be retrieved. Must be a subset of Problem fields
filter	list of strings	Filtering is not used	If present, only problems with given identifiers will be in the response.
limit	integer	20	Maximum number of recources, which will be returned.
offset	integer	0	Index of first resource, which should be returned (used for pagination).
sort	sort	-created_at	One of the Problem fields, which should be used for sorting the items. Order is ascending, to reverse the order, use - at the begining of the string.

Example

Request

curl https://api.aiforces.com/v1/problems \
    -X GET \
    -G \
    -d show_private=false \
    -d fields=name \
    -d fields=description \

Response

[
    {
        "name": "go",
        "description": "Abstract strategy board game"
    },

    {
        "name": "chess",
        "description": "Classical indian game"
    }
]

[GET] /problems/:problem-short-name

Retrieve general information about given problem.

Returns

Problem object

Arguments

Argument	Format	Default	Description
fields	list of strings	All Problem fields	fields Fields, which will be retrieved. Must be a subset of Problem fields

Example

Request

curl https://api.aiforces.com/v1/problems/tron \
    -X GET \
    -G \
    -d fields=id \
    -d fields=name \
    -d fields=access \

Response

{
    "id": 23,
    "name": "Tron",
    "access": "Public"
}

[POST] /problems

Creates a problem. If short-name is not given, it will be automatically generated using Display name and returned in

Arguments

Field	Format	Description
short_name	string	Problem unique short name.
name	string	Problem name. May be localized.
access	string	Problem access modifier. Either private, public or protected.
description	string	Description of the problem.
owners	array	Owners of the contest.
authors	object (dict)	Authors of the contest.
minimal_players	integer	Minimal number of players in one challenge.
maximal_players	integer	Maximal number of players in one challenge.
time-limit	integer	Per move time limit in microseconds
memory-limit	integer	RAM limit in bytes.

Returns

200 OK

[PUT] /problems/:problem-short-name

Creates problem. Similar to POST

[PATCH] /problems/:problem-short-name

Changes problem’s settings. Args similar to POST, but optional.

[GET] /problems/tests

Returns info about tests in the way, the way, described in Problemsetting/Tests/Configuration file. Instead of filenames, returns corresponding MediaAPI links.

[GET] /problems/solutions

Returns array of submission-label, created from the problem inner solutions.

[DELETE] /problems/:problem-short-name

Deletes the problem.

[GET] /problems/:problem-short-name/git

Retrieve info about problem git configuration.

Returns

Git info object, describing git settings for the problem.

Arguments

Argument	Format	Default	Description
fields	list of strings	Git info fields	Fields, which will be retrieved. Must be a subset of Git info fields

Example

Request

curl https://api.aiforces.com/v1/problems/tron/git \
    -X GET \
    -G \
    -d fields=branch \
    -d fields=commit \

Response

{
    "branch": "master",
    "commit": {
        "hash": "2872f3cbf85bcb96196f6901d56df8d80b337c58",
        "name": "Refactoring checker."
    }
}

[PATCH] /problems/:problem-short-name/git

Changes git settings for the problem.

[PATCH] /problems/:problem-short-name/git/fetch

Request fetching from the origin.

[GET] /problems/:problem-short-name/git/log

View git log.

[POST] /problems/:problem-short-name/git/webhooks

Endpoint for receiving git webhooks about the problem’s repository.