Problems

Endpoints for managing problems

[ADMIN] Get all problems

get

Retrieves a list of all problems.

Authorizations

JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

*/*

objectOptional

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/problems

HTTPcURLJavaScriptPython

GET /api/problems HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{}

[ADMIN] Create a new problem

post

Creates a new problem using the provided data.

Authorizations

JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringRequired

Name of the problem

Example: Sum of Two Numbers

descriptionstringRequired

Description of the problem

Example: Calculate the sum of two integers.

inDatastringRequired

Input data for the problem

Example: 1

outDatastringRequired

Expected output data for the problem

Example: 3

testsstringRequired

Test cases for the problem (JSON)

Example: {"in":"1","out":"3"}

examplesstringRequired

Example cases for the problem (JSON)

Example: {"in":"1","out":"3"}

Responses

200

OK

*/*

idinteger · int64Required

Unique identifier of the problem

Example: 1

namestringRequired

Name of the problem

Example: Sum of Two Numbers

descriptionstringRequired

Description of the problem

Example: Calculate the sum of two integers.

inDatastringRequired

Input data for the problem

Example: 1

outDatastringRequired

Expected output data for the problem

Example: 3

examplesstringRequired

Example cases for the problem

Example: Input: 1 2, Output: 3

publicbooleanOptional

Indicates if the problem is public

Example: true

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

post

/api/problems

HTTPcURLJavaScriptPython

POST /api/problems HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "name": "Sum of Two Numbers",
  "description": "Calculate the sum of two integers.",
  "inData": 1,
  "outData": 3,
  "tests": {
    "in": "1",
    "out": "3"
  },
  "examples": {
    "in": "1",
    "out": "3"
  }
}

{
  "id": 1,
  "name": "Sum of Two Numbers",
  "description": "Calculate the sum of two integers.",
  "inData": 1,
  "outData": 3,
  "examples": "Input: 1 2, Output: 3",
  "public": true
}

[ADMIN] Get problem by ID

get

Retrieves a problem by its ID. Required admin role

Authorizations

JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idinteger · int64Required

Responses

200

OK

*/*

idinteger · int64Required

Unique identifier of the problem

Example: 1

namestringRequired

Name of the problem

Example: Sum of Two Numbers

descriptionstringRequired

Description of the problem

Example: Calculate the sum of two integers.

inDatastringRequired

Input data for the problem

Example: 1

outDatastringRequired

Expected output data for the problem

Example: 3

examplesstringRequired

Example cases for the problem

Example: Input: 1 2, Output: 3

publicbooleanOptional

Indicates if the problem is public

Example: true

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/problems/{id}

HTTPcURLJavaScriptPython

GET /api/problems/{id} HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "name": "Sum of Two Numbers",
  "description": "Calculate the sum of two integers.",
  "inData": 1,
  "outData": 3,
  "examples": "Input: 1 2, Output: 3",
  "public": true
}

[ADMIN] Update a problem

patch

Applies partial updates to a problem by its ID.

Authorizations

JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idinteger · int64Required

Body

application/json

anyOptional

Responses

200

OK

*/*

idinteger · int64Required

namestringRequired

descriptionstringRequired

inDatastringRequired

outDatastringRequired

testsstringRequired

examplesstringRequired

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

patch

/api/problems/{id}

HTTPcURLJavaScriptPython

PATCH /api/problems/{id} HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*

{
  "id": 1,
  "name": "text",
  "description": "text",
  "inData": "text",
  "outData": "text",
  "tests": "text",
  "examples": "text"
}

[ADMIN] Get problem by ID (extra fields)

get

Retrieves a problem by its ID with admin-level access. Required admin role

Authorizations

JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idinteger · int64Required

Responses

200

OK

*/*

idinteger · int64Required

namestringRequired

descriptionstringRequired

inDatastringRequired

outDatastringRequired

testsstringRequired

examplesstringRequired

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/problems/{id}/admin

HTTPcURLJavaScriptPython

GET /api/problems/{id}/admin HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "name": "text",
  "description": "text",
  "inData": "text",
  "outData": "text",
  "tests": "text",
  "examples": "text"
}