Difference between revisions of "API:priv:submit-run"

From EjudgeWiki
(Created page with "Навигация: Главная страница/Система ejudge/Использование/API/API:priv:submit-run|submit-run (приви...")
 
(...)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[API]]/[[API:priv:submit-run|submit-run (привилегированный)]]
 
Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[API]]/[[API:priv:submit-run|submit-run (привилегированный)]]
 +
 +
Запрос отправляет на проверку файл с исходным кодом.
 +
 +
Уровень доступа: администратор в контесте (аутентификация с
 +
помощью API key или EJSID/session_id).
 +
 +
Method: <code>POST</code>
 +
 +
Content-type: <code>multipart/form-data</code>
 +
 +
Параметры:
 +
* <code>contest_id</code> (int) - идентификатор турнира
 +
* <code>action</code> (string) &mdash; строка <code>submit-run</code>.
 +
* <code>sender_user_login</code> (string, optional) &mdash; логин пользователя, от имени которого выполняется посылка.
 +
* <code>sender_user_id</code> (int, optional) &mdash; user id пользователя (если не задан sender_user_login).
 +
* <code>sender_ip</code> (string, optional) &mdash; IP-адрес отправителя.
 +
* <code>sender_ssl_flag</code> (int, optional) &mdash; 1, если протокол HTTPS; 0, если HTTP.
 +
* <code>problem_uuid</code> (uuid, *) &mdash; UUID задачи, если присутствует, то поиск задачи выполняется по UUID.
 +
* <code>problem_name</code> (string, *) &mdash; либо short_name задачи, либо internal_name задачи.
 +
* <code>problem</code> (int, *) &mdash; id задачи.
 +
* <code>variant</code> (int, optional) &mdash; вариант задачи.
 +
* <code>language_name</code> (string, **) &mdash; короткое имя (short_name) языка программирования.
 +
* <code>lang_id</code> (int, **) &mdash; либо id (int) языка программирования либо короткое имя (string) языка программирования.
 +
* <code>eoln_type</code> (int, optional) &mdash; тип преобразования концов строк.
 +
* <code>is_visible</code> (int, optional) &mdash; если значение &gt; 0, посылка не будет "невидимой".
 +
* <code>file</code> (string, ***) &mdash; исходный код программы.
 +
* <code>text_form</code> (string, ***) &mdash; исходный код программы (альтернатива для file).
 +
* <code>not_ok_is_cf</code> (int, optional) &mdash; если значение положительно, любой не-OK вердикт по этой посылке будет рассматриваться как Check Failed ([[Изменения в версии 3.10.1|3.10.1]]).
 +
* <code>rejudge_flag</code> (int, optional) &mdash; если значение положительно,
 +
посылка будет тестироваться с пониженным приоритетом, как при перетестировании ([[Изменения в версии 3.10.1|3.10.1]]).
 +
* <code>ext_user_kind</code>, <code>ext_user</code> &mdash; [[Внешние идентификаторы пользователей|внешний идентификатор пользователя]] ([[Изменения в версии 3.11.0|3.11.0]]).
 +
* <code>notify_driver</code>, <code>notify_kind</code>, <code>notify_queue</code> &mdash; [[Нотификации во внешние системы|идентификатор очереди сообщений]] ([[Изменения в версии 3.11.0|3.11.0]]).
 +
 +
Из параметров <code>problem_uuid</code>, <code>problem_name</code>, <code>problem</code> должен быть указан только один.
 +
 +
Из параметров <code>language_name</code>, <code>lang_id</code> должен быть
 +
указан только один.
 +
 +
Из параметров <code>file</code>, <code>text_form</code> должет быть
 +
указан только один.
 +
 +
Response content type: <code>application/json</code>
 +
 +
В случае ошибки возвращается JSON:
 +
 +
{
 +
  "ok": false,
 +
  "server_time": UNIX-TIMESTAMP,
 +
  "action": "submit-run",
 +
  "error": {
 +
    "num": ERROR-CODE,
 +
    "symbol": ERROR-SYMBOL,
 +
    "message": ERROR-MESSAGE
 +
  }
 +
}
 +
 +
В случае успеха возвращается JSON:
 +
 +
{
 +
  "ok": true,
 +
  "result": {
 +
    "run_id": ID,
 +
    "run_uuid": UUID
 +
  }
 +
}

Latest revision as of 17:36, 27 January 2024

Навигация: Главная страница/Система ejudge/Использование/API/submit-run (привилегированный)

Запрос отправляет на проверку файл с исходным кодом.

Уровень доступа: администратор в контесте (аутентификация с помощью API key или EJSID/session_id).

Method: POST

Content-type: multipart/form-data

Параметры:

  • contest_id (int) - идентификатор турнира
  • action (string) — строка submit-run.
  • sender_user_login (string, optional) — логин пользователя, от имени которого выполняется посылка.
  • sender_user_id (int, optional) — user id пользователя (если не задан sender_user_login).
  • sender_ip (string, optional) — IP-адрес отправителя.
  • sender_ssl_flag (int, optional) — 1, если протокол HTTPS; 0, если HTTP.
  • problem_uuid (uuid, *) — UUID задачи, если присутствует, то поиск задачи выполняется по UUID.
  • problem_name (string, *) — либо short_name задачи, либо internal_name задачи.
  • problem (int, *) — id задачи.
  • variant (int, optional) — вариант задачи.
  • language_name (string, **) — короткое имя (short_name) языка программирования.
  • lang_id (int, **) — либо id (int) языка программирования либо короткое имя (string) языка программирования.
  • eoln_type (int, optional) — тип преобразования концов строк.
  • is_visible (int, optional) — если значение > 0, посылка не будет "невидимой".
  • file (string, ***) — исходный код программы.
  • text_form (string, ***) — исходный код программы (альтернатива для file).
  • not_ok_is_cf (int, optional) — если значение положительно, любой не-OK вердикт по этой посылке будет рассматриваться как Check Failed (3.10.1).
  • rejudge_flag (int, optional) — если значение положительно,

посылка будет тестироваться с пониженным приоритетом, как при перетестировании (3.10.1).

Из параметров problem_uuid, problem_name, problem должен быть указан только один.

Из параметров language_name, lang_id должен быть указан только один.

Из параметров file, text_form должет быть указан только один.

Response content type: application/json

В случае ошибки возвращается JSON: 

{
  "ok": false,
  "server_time": UNIX-TIMESTAMP,
  "action": "submit-run",
  "error": {
    "num": ERROR-CODE,
    "symbol": ERROR-SYMBOL,
    "message": ERROR-MESSAGE
  }
}

В случае успеха возвращается JSON: 

{
  "ok": true,
  "result": {
    "run_id": ID,
    "run_uuid": UUID
  }
}
Retrieved from "https://www.ejudge.ru/wiki/index.php?title=API:priv:submit-run&oldid=6785"