{ "openapi": "3.0.3", "info": { "title": "MOJ API", "version": "v1", "description": "API REST do MOJ (Melhor Online Judge). Backend bash atrás de nginx+fcgiwrap. Auth via `Authorization: Bearer `. Histórico e placar são TXT; o resto é JSON com envelope `{success:true,…}` ou `{success:false,error:{message,code}}`. Horários em EPOCH." }, "servers": [ { "url": "/api/v1", "description": "Instância atual" } ], "tags": [ { "name": "auth" }, { "name": "index" }, { "name": "treino" }, { "name": "submission" }, { "name": "contest" }, { "name": "admin" }, { "name": "ops" }, { "name": "treino-admin" }, { "name": "problems", "description": "Gestão e autoria de problemas do treino. Escrita keyless (git escondido; commit autorado pelo login via git-broker.sh). source/create/edit cobrem o pacote canônico inteiro." } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer" } }, "parameters": { "contest": { "name": "contest", "in": "query", "required": true, "schema": { "type": "string" }, "description": "id do contest (ex.: treino)" } }, "schemas": { "ProblemExample": { "type": "object", "description": "Exemplo (sample) — sempre aparente no enunciado.", "properties": { "input": { "type": "string" }, "output": { "type": "string" }, "explanation": { "type": "string", "description": "Markdown opcional; aparece logo após o exemplo no enunciado (gravado em docs/sample-notes.json, na ordem)." } }, "required": [ "input", "output" ] }, "ProblemTest": { "type": "object", "description": "Teste oculto.", "properties": { "name": { "type": "string" }, "input": { "type": "string" }, "output": { "type": "string" }, "group": { "type": "string", "description": "Grupo de pontuação (subtask), opcional." } }, "required": [ "input", "output" ] }, "ProblemSol": { "type": "object", "properties": { "filename": { "type": "string" }, "code": { "type": "string" } }, "required": [ "filename", "code" ] }, "ProblemSols": { "type": "object", "description": "Soluções por categoria (cada lista de {filename,code}). good define o tempo-limite; wrong deve falhar; slow deve estourar o tempo.", "properties": { "good": { "type": "array", "items": { "$ref": "#/components/schemas/ProblemSol" } }, "slow": { "type": "array", "items": { "$ref": "#/components/schemas/ProblemSol" } }, "wrong": { "type": "array", "items": { "$ref": "#/components/schemas/ProblemSol" } }, "pass": { "type": "array", "items": { "$ref": "#/components/schemas/ProblemSol" } }, "upcoming": { "type": "array", "items": { "$ref": "#/components/schemas/ProblemSol" } } } }, "ProblemScore": { "type": "object", "description": "Pontuação por grupos (subtasks). O valor do problema é a soma dos pesos (pode passar de 100).", "properties": { "enabled": { "type": "boolean" }, "groups": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "weight": { "type": "number" }, "glob": { "type": "string", "description": "Padrão glob dos testes do grupo. Pode ser uma LISTA de padrões separados por \", \" (ex.: \"g2_*, g3_*\") — todos casam o mesmo peso." } } } } } }, "ProblemFields": { "type": "object", "description": "Campos do pacote canônico — source/create/edit cobrem o todo. Em edit, só os campos presentes são gravados.", "properties": { "title": { "type": "string", "description": "Título — vem do CAMPO (não de '% Título' no texto); o renderizador injeta o

." }, "enunciado_md": { "type": "string" }, "enunciado_format": { "type": "string", "enum": [ "md", "org", "tex" ] }, "author": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "conf_text": { "type": "string", "description": "conf do pacote (TLMOD/ULIMITS/STOPWHEN/MEMLIMITMB/…)." }, "public": { "type": "boolean" }, "collections": { "type": "array", "items": { "type": "string" } }, "languages": { "type": "array", "description": "Ids de linguagem de submissão permitidos deste problema ([]/ausente = todas as PADRÃO). Linguagens exóticas/opt-in (pddl/grepe/sas/l/lpp/downward, e ids custom futuros) só aparecem no dropdown quando DECLARADAS aqui. Em edit: ausente = não toca; [] = limpa.", "items": { "type": "string" } }, "examples": { "type": "array", "items": { "$ref": "#/components/schemas/ProblemExample" } }, "tests": { "type": "array", "items": { "$ref": "#/components/schemas/ProblemTest" } }, "sols": { "$ref": "#/components/schemas/ProblemSols" }, "score": { "$ref": "#/components/schemas/ProblemScore" }, "editorial_md": { "type": "string", "description": "Resolução em markdown (docs/solucao.md). SÓ p/ setter — não vai ao aluno; opcional para liberar." } } } } }, "paths": { "/auth/login": { "post": { "tags": [ "auth" ], "summary": "Login → token", "parameters": [ { "$ref": "#/components/parameters/contest" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" } }, "required": [ "username", "password" ] } } } }, "responses": { "200": { "description": "{token, logged_in, username, name, contest}" }, "401": { "description": "credenciais inválidas" } }, "description": "Em contest (≠ treino), a resposta inclui server_utc, offline_pubkey_pem e beacon (kit da submissão offline do moj-comp)." } }, "/auth/status": { "get": { "tags": [ "auth" ], "summary": "Status da sessão", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "contest", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "{logged_in, login, name, is_admin, is_judge, is_staff, is_cstaff, is_chief, has_photo} (.cstaff = chefe de sede, não herda is_staff; has_photo evita que o avatar peça uma foto inexistente)" } } } }, "/auth/logout": { "post": { "tags": [ "auth" ], "summary": "Logout (apaga o arquivo de sessão mesmo se ela já não vale)", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "{logged_out:true}" } } } }, "/index/news": { "get": { "tags": [ "index" ], "summary": "Notícias", "responses": { "200": { "description": "{news:[{id,title,date,summary,url}]}" } } } }, "/index/contests": { "get": { "tags": [ "index" ], "summary": "Contests (abertos/por vir/encerrados); problems_count é 0 em contest por vir (não revela a quantidade de problemas antes do início)", "parameters": [ { "name": "page", "in": "query", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "{open,upcoming,closed:{items,page,pages}}" } } } }, "/index/open_training": { "get": { "tags": [ "index" ], "summary": "Destaques do treino (top10, recentes, semana)", "responses": { "200": { "description": "{top_users,recent_solved,most_solved_week}" } } } }, "/treino/problems": { "get": { "tags": [ "treino" ], "summary": "Lista de problemas", "responses": { "200": { "description": "[{id,title,tags,collections,solved_count,attempted_count,public_at?}] (collections = .moj-meta.json do pacote; um problema pode estar em várias; public_at = epoch da 1ª publicação, ausente quando desconhecido)" } } } }, "/treino/trending": { "get": { "tags": [ "treino" ], "summary": "Top-10 problemas por submissões nos últimos 7 dias (estado inicial do Treino Livre); anônimo, sem problemas privados, cache var/trending.json com piso 6h", "responses": { "200": { "description": "{success,window_days:7,generated_at,problems:[{id,title,count,url}]} ordenado por count desc" } } } }, "/treino/problem": { "get": { "tags": [ "treino" ], "summary": "Problema (enunciado b64, autor, time limits, tags, coleções)", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "{id,title,author,statement_html_b64,time_limits,tags,collections,languages} (author = arquivo 'author' do pacote, verbatim; vários juntados por ', '; vazio se ausente; collections = coleções do .moj-meta.json; languages = ids de linguagem de submissão permitidos, [] = todas as PADRÃO — o front filtra o dropdown; exóticas/opt-in (pddl/grepe/sas/l/lpp/downward) só aparecem quando o problema as declara)" }, "404": { "description": "não encontrado" } } } }, "/treino/solvetry": { "get": { "tags": [ "treino" ], "summary": "Resolvidos/tentados de um usuário", "parameters": [ { "name": "user", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "{solved:[ids],attempted:[ids]}" } } } }, "/treino/history": { "get": { "tags": [ "treino" ], "summary": "Histórico do usuário no problema (TXT)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "TXT: tempo:user:probid:lang:veredito:epoch:subid — veredito SEMPRE canônico (Accepted/Wrong Answer/…; pendentes e strings desconhecidas intactos); o detalhe (testes/pontos/grupos) vem do /submission/summary", "content": { "text/plain": {} } } } } }, "/treino/history-full": { "get": { "tags": [ "treino" ], "summary": "Histórico completo do usuário (TXT)", "parameters": [ { "name": "user", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "TXT (7 campos) — veredito SEMPRE canônico; visitante do perfil público vê só o rótulo (o resumo do /submission/summary é só do dono)", "content": { "text/plain": {} } } } } }, "/treino/profile": { "get": { "tags": [ "treino" ], "summary": "Perfil (próprio com Bearer; ?user=X = visão pública, respeita privacidade; ambos trazem created_at, epoch de criação da conta)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "user", "in": "query", "schema": { "type": "string" }, "description": "ver perfil público de outro usuário" } ], "responses": { "200": { "description": "perfil próprio: dados + cota de username + telegram:{linked,username,linked_at,changes_used,changes_limit,changes_remaining,next_available} (vínculo do login, sem o telegram_id; changes_limit null = .admin, livre); ?user=X: visão pública" } } }, "post": { "tags": [ "treino" ], "summary": "Atualiza nome, universidade, editor favorito e/ou privacidade", "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "university": { "type": "string" }, "favorite_editor": { "type": "string" }, "profile_public": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "perfil atualizado" } } } }, "/treino/profile/photo": { "get": { "tags": [ "treino" ], "summary": "Foto de perfil (png 100x100)", "parameters": [ { "name": "user", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "image/png", "content": { "image/png": {} } }, "404": { "description": "sem foto / privado" } } }, "post": { "tags": [ "treino" ], "summary": "Envia foto (redimensiona p/ 100x100)", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "image_b64": { "type": "string" } }, "required": [ "image_b64" ] } } } }, "responses": { "200": { "description": "{updated:true}" } } } }, "/treino/editors": { "get": { "tags": [ "treino" ], "summary": "Ranking dos editores favoritos declarados", "responses": { "200": { "description": "{editors:[{editor,count}], total}" } } } }, "/treino/achievements": { "get": { "tags": [ "treino" ], "summary": "Registro de conquistas do perfil (custom do admin ou default embarcado; avaliação no cliente — docs/PERFIL.md)", "responses": { "200": { "description": "{custom, version, achievements:[{id,icon,pt,en,kind,params,enabled}]}" } } } }, "/treino/admin/achievements": { "post": { "tags": [ "treino-admin" ], "summary": "Salva o registro de conquistas ({achievements:[…]} validado) ou restaura o padrão ({restore_default:true}); .admin", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "{saved,count} | {restored:true}" }, "400": { "description": "achievements_invalid (primeira mensagem de validação)" } } } }, "/treino/problem-stats": { "get": { "tags": [ "treino" ], "summary": "Estatísticas de um problema (cacheado)", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "{total_submissions,distinct_attempted,distinct_solved,acceptance_rate,verdicts,by_language:[{lang,submissions,accepted,solvers}],editors,solver_avatars,solvers_public_count, daily:{YYYY-MM-DD:n}, monthly:[{m,subs,ac}], dow_hour:[{dow,hour,n}], first_ac_epochs:[epoch], tries:[{bucket,n}], tries_median, time_to_solve:[{bucket,n}], t2s_median, facts:{first_sub_epoch,last_sub_epoch,peak_day:{date,n},first_solver:{epoch,login?,name?}}, difficulty_percentile:{harder_than_pct,cohort,success_rate}|null, runtimes:[{lang,t}]} — datas/horas em America/Sao_Paulo; first_solver só expõe login/nome se o perfil for público; percentil = taxa de sucesso por usuário vs. acervo público (≥5 tentantes, coorte ≥10); runtimes = teste mais lento de cada ACEITA (results/ da era atual)" } } } }, "/treino/admin/activity-log": { "get": { "tags": [ "treino-admin" ], "summary": "Feed COMPLETO de atividade do treino (login/submit/verdict/read/admin; calib opt-in) com filtros e format=csv (range inteiro p/ análise)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "since", "in": "query", "schema": { "type": "integer" } }, { "name": "until", "in": "query", "schema": { "type": "integer" } }, { "name": "kinds", "in": "query", "schema": { "type": "string" }, "description": "csv de tipos (login,submit,verdict,read,admin,calib); vazio = tudo menos calib" }, { "name": "user", "in": "query", "schema": { "type": "string" } }, { "name": "action", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer" } }, { "name": "format", "in": "query", "schema": { "type": "string", "enum": [ "csv" ] } } ], "responses": { "200": { "description": "{count, events:[{time,who,kind,action,details,ip}]} ou text/csv (attachment)" }, "403": { "description": "não é admin" } } } }, "/treino/admin/managed-users": { "get": { "tags": ["treino-admin"], "summary": "Contas GERIDAS (menores, sem Telegram — docs/CONTAS-GERIDAS.md); .admin", "security": [{"bearerAuth": []}], "responses": {"200": {"description": "{users:[{login,fullname,by,note,birthdate,minor,expires_at,disabled,created_at}]}"}} } }, "/treino/admin/managed-create": { "post": { "tags": ["treino-admin"], "summary": "Cria contas geridas {users:[{fullname,birthdate,login?,note?,expires_at?}]} (1..500); senhas devolvidas UMA vez; .admin", "security": [{"bearerAuth": []}], "responses": {"200": {"description": "{created:[{login,password,fullname,birthdate}], skipped:[{reason}]}"}} } }, "/treino/admin/managed-reset": { "post": { "tags": ["treino-admin"], "summary": "Senha nova p/ conta gerida {login} (devolvida uma vez; derruba sessões); .admin", "security": [{"bearerAuth": []}], "responses": {"200": {"description": "{reset, login, password, sessions_removed}"}} } }, "/treino/admin/managed-update": { "post": { "tags": ["treino-admin"], "summary": "Edita conta gerida {login, note?, birthdate?, expires_at?|null, disabled?}; disabled:false devolve senha nova; .admin", "security": [{"bearerAuth": []}], "responses": {"200": {"description": "{updated, login, password?}"}} } }, "/treino/admin/managed-remove": { "post": { "tags": ["treino-admin"], "summary": "Remove conta gerida {login} (arquiva em .removed-users); .admin", "security": [{"bearerAuth": []}], "responses": {"200": {"description": "{removed, login}"}} } }, "/treino/admin/sessions": { "get": { "tags": [ "treino-admin" ], "summary": "Sessões ativas (login, IP, User-Agent)", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "{count,sessions:[{login,name,ip,user_agent,login_at}]}" }, "403": { "description": "não-admin" } } } }, "/treino/admin/access-log": { "get": { "tags": [ "treino-admin" ], "summary": "Log de acessos (filtra por dia)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "day", "in": "query", "schema": { "type": "string" }, "description": "YYYY-MM-DD" } ], "responses": { "200": { "description": "{day,entries:[{time,login,ip,user_agent}]}" } } } }, "/treino/admin/queue": { "get": { "tags": [ "treino-admin" ], "summary": "Submissões pendentes por lista + spool + fila de calibração. details=1 lista CADA pendente (quem, o quê, desde quando, estado no pipeline, teto 100); sub=:: devolve o dossiê de uma (history, mojlog, fonte)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "string" }, "description": "1 = inclui pending_details:[{contest,login,problem,lang,id,since,age_s,state,has_source}]" }, { "name": "sub", "in": "query", "required": false, "schema": { "type": "string" }, "description": ":: — dossiê de UMA pendente: {history_line,state,has_source,source_bytes,mojlog,mojlog_bytes}" } ], "responses": { "200": { "description": "{total_pending,spool_queued,calib_pending,calib_inflight,calib_targeted,lists:[{contest,name,pending}],pending_details:[…]}. Inclui `routing` (shards do escritor): {shards, workers:[{shard, alive_age_s, in_submit, in_results, in_other}], orphans, queue_depth, assigned, delivered_5m}" } } }, "post": { "tags": [ "treino-admin" ], "summary": "Agir sobre uma pendente (auditado queue-resolve): requeue re-enfileira (409 no_source sem fonte); resolve aplica Judge Error|Compilation Error via setverdict", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string", "enum": ["requeue", "resolve"] }, "contest": { "type": "string" }, "login": { "type": "string" }, "id": { "type": "string" }, "verdict": { "type": "string", "enum": ["Judge Error", "Compilation Error"] } } } } } }, "responses": { "200": { "description": "{requeued:true}|{resolved:true,verdict}" }, "409": { "description": "no_source (requeue sem fonte arquivada)" } } } }, "/treino/admin/judges": { "get": { "tags": [ "treino-admin" ], "summary": "Máquinas de juiz (modelo pull) + o que cada uma roda agora", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "{online,busy,machines:[{host,online,busy,status,langs,cage_root,cache,tl,current,current_jobs,queued_calibrate,slots,partition,topology,config,report}]} — current_jobs = TODOS os jobs em execução (um por slot ocupado, {kind:submission|calibrate|index|draining|disabled|unknown_busy, problem_id, since:epoch-do-claim, ...}); current = o 1º (compat); status = auto-relato do agente (ok|draining|disabled, null=agente antigo); slots:{free,total}; cache = pacotes EM DISCO (não RAM); queued_calibrate = calibrações direcionadas na fila do host" } } } }, "/treino/admin/stats": { "get": { "tags": [ "treino-admin" ], "summary": "Números p/ gráficos + contagem/entrada de problemas + por autor", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "{users,active_sessions,problems:{total,public,private},by_author:[{author,owner,total,public,private}],problems_public_by_day:[{day,count}],logins_per_day,submissions_per_day} — contagens da plataforma (privados contados, NÃO listados); public_by_day = entrada de públicos (data aproximada)" } } } }, "/treino/admin/response-stats": { "get": { "tags": [ "treino-admin" ], "summary": "Tempo de resposta + volume de submissões (média/dia + mapas de calor)", "description": "Cacheado (regenera quando history/results mudam). Tempo (espera/julgamento/fila) só de submissões com finalized_at; VOLUME (subs_per_day/subs_by_dow_hour) conta TODAS as linhas do history. EPOCH/UTC.", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "{coverage, overall, per_day, by_dow_hour, subs_per_day:[{day,count}], subs_by_dow_hour:[{dow,hour,n}]}" }, "403": { "description": "não-admin (admin_required)" } } } }, "/treino/admin/calib-activity": { "get": { "tags": [ "treino-admin" ], "summary": "Volume de calibrações no tempo (por dia + dia-da-semana × hora)", "description": "Cacheado (regenera quando o log run/updates/log muda). Conta os eventos 'cacheado+calibrado' do log append-only. run/ NÃO é versionado e pode rotacionar -> cobertura histórica parcial.", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "{calib_per_day:[{day,count}], calib_by_dow_hour:[{dow,hour,n}], total}" }, "403": { "description": "não-admin (admin_required)" } } } }, "/treino/admin/logout-user": { "post": { "tags": [ "treino-admin" ], "summary": "Desloga um usuário (remove sessões)", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "login": { "type": "string" }, "logins": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "{logged_out,sessions_removed}" } } } }, "/treino/admin/lock-user": { "post": { "tags": [ "treino-admin" ], "summary": "Trava acesso (troca senha por aleatória + desloga)", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "login": { "type": "string" }, "logins": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "{locked,sessions_removed}" } } } }, "/treino/admin/logout-ip": { "post": { "tags": [ "treino-admin" ], "summary": "Desloga todas as sessões de um IP", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ip": { "type": "string" } }, "required": [ "ip" ] } } } }, "responses": { "200": { "description": "{logged_out,ip,sessions_removed,users,users_count}" } } } }, "/treino/profile/password": { "post": { "tags": [ "treino" ], "summary": "Troca a própria senha", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "old_password": { "type": "string" }, "new_password": { "type": "string" } }, "required": [ "old_password", "new_password" ] } } } }, "responses": { "200": { "description": "{updated:true}" }, "403": { "description": "senha atual incorreta" } } } }, "/treino/contest-registration": { "get": { "tags": [ "treino" ], "summary": "Inscrição do próprio login num contest que usa as contas do treino (individual ou time de até 3 contas existentes): janela ancorada na PROVA OFICIAL (o aquecimento pode ficar dias no ar), minha situação, meu time e convites recebidos", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "contest", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "{enabled,contest,contest_name,start_time,end_time,window:{state,opens_at,closes_at,late_until,official_start,official_round},round_kind,gate_active,team_max,teams_allowed,me,team,invites,totals}" }, "409": { "description": "not_shared (contest sem USERS_FROM)" } } }, "post": { "tags": [ "treino" ], "summary": "Ações da inscrição: register {univ?,ai?,flag?} | individual-meta {univ?,ai?,flag?} (o INDIVIDUAL declara/edita universidade, IA e bandeira — paridade com o team-meta) | team-create {name,univ?,ai?,flag?} | team-invite {login} (o mojinho manda DM ao convidado com o link de aceitar/recusar) | team-accept | team-decline | team-rename | team-meta {univ?,ai?,flag?} | team-photo {image_b64}. Modo de participação é DEFINITIVO (403 mode_locked em cancel/leave/dissolve/troca); warmup também exige inscrição por padrão (REG_WARMUP_OPEN=y libera)", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contest": { "type": "string" }, "action": { "type": "string" }, "name": { "type": "string" }, "login": { "type": "string" }, "team": { "type": "string" } }, "required": [ "contest", "action" ] } } } }, "responses": { "200": { "description": "estado completo da inscrição (mesmo shape do GET)" }, "403": { "description": "registration_closed | registration_not_open" }, "409": { "description": "registration_off | already_registered | in_team | team_full | name_taken" } } } }, "/treino/profile/username": { "post": { "tags": [ "treino" ], "summary": "Troca o próprio username (máx. 2/ano + cascata, incluindo TODAS as sessões do login — outra aba, outro dispositivo, token do moj-cli — que passam a valer com o nome novo sem deslogar; sufixo de papel é PRESERVADO — sufixo(novo)==sufixo(atual): .admin troca p/ outro.admin, uname_role_suffix se derrubar o sufixo, uname_reserved se assumir um)", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "new_username": { "type": "string" } }, "required": [ "new_username" ] } } } }, "responses": { "200": { "description": "{updated:true,new_username,username_changes_used,username_changes_remaining,sessions_updated}" }, "403": { "description": "limite anual atingido" }, "409": { "description": "em uso ou submissões pendentes" } } } }, "/submit": { "post": { "tags": [ "submission" ], "summary": "Submeter solução (assíncrono). Gate por fase+papel: admin/judge sempre; staff nunca (403 submit_forbidden); normal e mon só durante a janela (403 contest_not_started / contest_ended; mon fica fora do placar). Whitelist de linguagens FORÇADA (400 lang_not_allowed): extensão canonicalizada tem de estar na lista efetiva do problema (override do contest -> LANGUAGES -> pacote -> todas) Teto SUBMIT_MAX_KB (1024) -> 413 source_too_large; whitelist vazia = as linguagens da PLATAFORMA (.exe -> 400); fail-closed: spool validado antes do OK (500 spool_write_failed, sem pendente fantasma)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "problem_id": { "type": "string" }, "filename": { "type": "string", "description": "Nome do arquivo da fonte. NORMALIZADO pelo servidor (safe_src_filename): sai o caminho, saem espaços, sai o '(N)' que o navegador gruda em download repetido (l(1).cpp -> l.cpp) e saem os metacaracteres de shell/make; acento é preservado. O juiz materializa a fonte com este nome e o entrega ao compilador." }, "code_b64": { "type": "string" } }, "required": [ "problem_id", "code_b64" ] } } } }, "responses": { "200": { "description": "{submission_id, status:\"queued\"}" } } } }, "/submission/source": { "get": { "tags": [ "submission" ], "summary": "Código-fonte de uma submissão", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "time", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "código (texto)", "content": { "text/plain": {} } } } } }, "/submission/log": { "get": { "tags": [ "submission" ], "summary": "Log do julgamento (report.html; expõe input+diff de todos os testes — dono vê conforme o SHOWLOG efetivo: explícito manda, ausente = oculto em modo icpc)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" }, { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "time", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "log (texto)", "content": { "text/plain": {} } } } } }, "/submission/summary": { "get": { "tags": [ "submission" ], "summary": "Resumo estruturado em lote (detalhe sob o veredicto canônico), REDIGIDO pelo modo do contest", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" }, { "name": "ids", "in": "query", "required": true, "schema": { "type": "string" }, "description": "csv de submission ids (até 1000)" } ], "responses": { "200": { "description": "{\"\":{verdict,verdict_canon,score,score_max,score_kind,correct,total,groups,heur_score?,heur_adjusted?}} — redigido por modo (lib/verdict.sh): full (treino/lista)=tudo; score (obi/heurístico/outro)=canônico+score/groups/heur sem correct/total; none (icpc/ausente)=só o canônico (nos níveis redigidos verdict=canônico; juiz/admin sempre full com verdict cru). groups=[{earned,max},…] na ordem do tests/score (earned null = grupo não executado; results antigos: canon derivado da string, groups da cauda 'Pontos | … |' com max:null). Mesmo gate do log; ids de terceiros omitidos" } } } }, "/contest/basic": { "get": { "tags": [ "contest" ], "summary": "Info pública (nome, horários, login_start_time)", "description": "Traz também balloon_style (icon|fill, default icon): como o placar pinta a célula de quem resolveu. icon = fundo neutro igual para todos + um ponto com a cor do balão, de modo que \"resolvido\" não dependa de enxergar a cor — a paleta ICPC dá o problema A BRANCO, e branco sobre o fundo branco do placar é o mesmo pixel (1,00:1), então o acerto sumia. fill = o clássico, cor do balão no fundo, mais um contorno derivado da própria cor para as claras não sumirem. Vale para o placar ao vivo, a cerimônia de revelação e o relatório offline. Ver docs/SCOREBOARD.md.", "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{contest_id,contest_name,start_time,end_time,login_start_time,locale,login_enabled,freeze_time,score_anon,languages[],secret} — languages = whitelist do conf LANGUAGES= ([] = todas); locale = pt|en explícito (IMPÕE o idioma da UI do contest) ou \"\" quando não setado (o front cai no seletor/idioma do browser)" } } } }, "/contest/userinfo": { "get": { "tags": [ "contest" ], "summary": "Info do usuário logado", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{login,name,…}" } } } }, "/contest/navbuttons": { "get": { "tags": [ "contest" ], "summary": "Botões de navegação por papel (.admin/.judge/.staff/.cstaff/.mon; .cstaff ganha Etiquetas e — pós-fim p/ todas as sedes — Revelação; .staff sem Etiquetas)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "[{label,url}]" } } } }, "/contest/statement": { "get": { "tags": ["contest"], "summary": "UM enunciado da prova, cru (html ou pdf), sob demanda", "description": "Gate IDENTICO ao de /contest/problems (can_see_problems): .staff/.cstaff nunca, competidor so depois do inicio, admin/juiz sempre — e a recusa e 404, nao 403: pedir o enunciado direto nao pode confirmar que o problema existe antes de a prova abrir. A chave do arquivo sai sempre do PROBS do conf, nunca do parametro. Responde ETag (mtime+tamanho) + Cache-Control: private, max-age=60 e honra If-None-Match com 304 — recarregar a pagina nao repuxa MB, e enunciado corrigido no meio da prova invalida sozinho.", "security": [{"bearerAuth": []}], "parameters": [ {"name": "contest", "in": "query", "required": true, "schema": {"type": "string"}}, {"name": "problem", "in": "query", "required": true, "description": "letra (short_name) ou problem_id canonico", "schema": {"type": "string"}}, {"name": "format", "in": "query", "description": "html (default) ou pdf", "schema": {"type": "string", "enum": ["html", "pdf"]}} ], "responses": { "200": {"description": "o enunciado (text/html; charset=utf-8 ou application/pdf)"}, "304": {"description": "If-None-Match casou o ETag — corpo vazio"}, "400": {"description": "problem ausente ou format invalido"}, "404": {"description": "sem permissao de ver, problema inexistente ou sem esse formato"} } } }, "/contest/problems": { "get": { "tags": [ "contest" ], "summary": "Problemas da prova. Gate: admin/judge veem sempre; staff nunca; normal só após o início (antes -> {problems:[], locked:'not_started'})", "description": "Resposta em CACHE por VARIANTE (author|noauthor). O payload é o mesmo para todo time; a única dimensão que o muda é o AUTOR do problema, que só aparece com a prova encerrada ou para admin/juiz-chefe/juiz — o cache por variante existe para que um GET do juiz nunca entregue o autor a um competidor. Invalida comparando com as entradas (conf, problem-langs.json, problem-judges.json, enunciados/, carimbo var/.problems-dirty tocado pelo admin e pela promocao de rodada) mais um teto de idade de 60s. O CORPO DO ENUNCIADO NAO VEM AQUI (2026-08-20): a lista traz apenas has_statement_html/has_statement_pdf e o conteudo sai por /contest/statement, quando a pessoa abre a sanfona ou clica em HTML/PDF. Vinha em base64, e num contest de PDF isso e 3,8 MB por time — 2000 times abrindo a prova ao mesmo tempo eram ~5 GB de uma vez.", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{problems:[{short_name,full_name,problem_id,statement_html_b64,statement_pdf_b64,time_limits,languages}]} (time_limits = MAX entre juízes; com pool de juízes definido — problem-judges.json -> CONTEST_JUDGES — só entre os hosts do pool efetivo. languages = ids permitidos: override por-problema-no-contest -> whitelist do contest -> default do próprio pacote (.moj-meta.json) -> [] (todas))" } } } }, "/contest/news": { "get": { "tags": [ "contest" ], "summary": "Notícias do contest (opcional)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "ok" } } } }, "/contest/updates": { "get": { "tags": [ "contest" ], "summary": "Resumo de novidades p/ polling (notícias + clarifications não lidas)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{news:{last,count,unread}, clar:{last,count,unread}}" } } } }, "/contest/backup": { "get": { "tags": [ "contest" ], "summary": "Lista os backups do próprio usuário", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{backups:[{id,name,size,time}]}" } } }, "post": { "tags": [ "contest" ], "summary": "Guarda/remove um backup de arquivo (versão de solução)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{filename,file_b64} guarda; {action:remove,id} remove" } } } }, "/contest/backup-file": { "get": { "tags": [ "contest" ], "summary": "Baixa um backup (próprio; login= só admin)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "arquivo (octet-stream)" } } } }, "/contest/print": { "get": { "tags": [ "contest" ], "summary": "Lista os pedidos de impressão do próprio usuário (+ flags staff_exists/allow_print)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{requests:[{id,seq,filename,mime,size,time,status,pages}], staff_exists, allow_print}" } } }, "post": { "tags": [ "contest" ], "summary": "Cria um pedido de impressão (gera nº sequencial)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{id,seq,status:pending} — body {filename,file_b64}, máx 10MB" }, "403": { "description": "print_unavailable (sem staff) | print_disabled (PRINT=0)" } } } }, "/contest/print-file": { "get": { "tags": [ "contest" ], "summary": "Baixa o arquivo cru de um pedido (dono/admin/staff no escopo; .cstaff não — 403)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "arquivo (Content-Disposition)" } } } }, "/contest/staff/queue": { "get": { "tags": [ "contest" ], "summary": "Fila de tarefas do staff (impressão + balões; escopo por staff-filters; .cstaff SÓ LÊ — ações/PDF 403). Reconcilia balões pendentes (1ª-AC) ao carregar. Cada balão traz first_site: é o primeiro daquela cor NA SEDE do time (★ na fila e na folha) — só sai decidido; havendo run mais antiga da sede por julgar, a tarefa espera até BALLOON_FIRST_WAIT_S e depois sai sem estrela", "description": "FREEZE: acerto com sub_epoch >= FREEZE_TIME NÃO vira tarefa de balão (o balão andando pela sala conta o que o placar congelado esconde) e a supressão é registrada em print-requests/.balloon-frozen — permanente, para que encerrar o evento (FREEZE_TIME=0) não a desfaça. Só o admin desfaz, ligando balloons_during_freeze no settings. Pedido de impressão NÃO é afetado pelo freeze. balloons_frozen (contagem dos suprimidos) só vai para o admin.", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{requests:[{id,seq,kind,login,team,univ,short,color_hex,color_name,filename,status,…}], balloons_frozen}" } } } }, "/contest/staff/print-action": { "post": { "tags": [ "contest" ], "summary": "Máquina de estado da tarefa: claim|processed|delivered (.staff/admin; .cstaff não — 403)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{updated:{id,seq,status,…}} — body {id,action,mode?}" }, "409": { "description": "already_claimed | not_pending | not_printed" } } } }, "/contest/staff/print-pdf": { "get": { "tags": [ "contest" ], "summary": "PDF inline (build-once): kind=print → folha de rosto + documento A4 (código numerado); kind=balloon → folha do balão (time/univ/login/problema/cor desenhada+nome/nº/assinatura). .staff/admin; .cstaff não — 403", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "application/pdf" } } } }, "/contest/badges": { "get": { "tags": [ "contest" ], "summary": "Credenciais p/ etiquetas imprimíveis (senha em claro — auditado badges-view). A lista sai SÓ do store local do contest, nunca da fonte USERS_FROM, e a senha só sai quando é credencial do contest que funciona: conta compartilhada vem com password vazia + shared_credential:true, e conta DESABILITADA vem com password vazia + disabled:true mesmo com include_disabled=1 (o ! do user-disable é aleatório; o de time é um uuid interno). Incidente de 2026-08-18. Admin/.cstaff apenas — .staff recebe 403 cstaff_required. Admin: tudo ou o arquivo de uma sede via staff=; .cstaff: só o próprio recorte (staff-filters) + as .staff do mesmo escopo — só o .staff ganha etiqueta (nenhuma conta .cstaff entra, nem a de quem olha). include_disabled=1 inclui contas desativadas", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{users:[{login,name,fullname,password,shared_credential,disabled,region,univ}], staff:[…só admin, logins .cstaff], regions, shared, contest_name, start_epoch} — shared = fonte USERS_FROM (vazio em contest de contas próprias)" }, "403": { "description": "cstaff_required | staff_scope" } } } }, "/contest/admin/staff-filters": { "get": { "tags": [ "contest-admin" ], "summary": "Escopo de cada usuário .staff/.cstaff (no .cstaff vale p/ fila-leitura, etiquetas e cerimônia) + lista de staff/regiões", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{staff:[{login,fullname,disabled}], filters:{login:[regex]}, regions:[{name,regex}]}" } } }, "post": { "tags": [ "contest-admin" ], "summary": "Grava o escopo por staff/cstaff (entradas region: — igualdade com a sede do time — ou regex no login; vazio = vê tudo)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{saved:true,filters} — body {filters:{login:[regex]}}" } } } }, "/contest/admin/preflight": { "get": { "tags": [ "contest-admin" ], "summary": "Checklist pré-prova, a lista da 🏁 Central do painel de admin (janela, SHOWLOG, freeze, juízes online, pool de juízes — estrito: fail se o pool do contest está todo offline; pool_problems p/ overrides por problema — toolchains e TL calibrado no pool efetivo, staff e o ESCOPO do staff, contas (sem contas de papel), balões sem cor, coortes, gate de navegador por sede, rodada seguinte com os bloqueadores, documentos gerados/publicados, prorrogação × freeze, spool)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{checks:[{id,level:ok|warn|fail,label,detail}], summary:{ok,warn,fail}} — ids: window, show_log, show_code, freeze, judges, pool, langs, problems, pool_problems, print, staff_filters, balloons, users, daemon, mode, manual, tov, cohorts, ua_gate, next_round, docs" } } } }, "/contest/admin/time-overrides": { "get": { "tags": [ "contest-admin" ], "summary": "Prorrogação de vigência por sede/grupo: regras [{regex,end,reason?}] no login (1ª que casa estende o fim SÓ daquele grupo)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{rules:[{regex,end,reason}], contest_end, regions} — aplicado no /submit e no countdown (contest_end_effective)" } } }, "post": { "tags": [ "contest-admin" ], "summary": "Substitui as regras de prorrogação (valida regex/end; só estende, nunca encurta; auditado)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{saved:true,rules} — body {rules:[{regex,end,reason?}]}" } } } }, "/contest/admin/backups": { "get": { "tags": [ "contest-admin" ], "summary": "Lista todos os backups (filtros user/q) + resumo por usuário", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{backups:[{login,id,name,size,time}],users:[{login,count,bytes}]}" } } } }, "/contest/admin/backup-zip": { "get": { "tags": [ "contest-admin" ], "summary": "Zip com todos os backups de um usuário", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "application/zip" } } } }, "/contest/nutella": { "get": { "tags": [ "contest" ], "summary": "Panorama das máquinas mlinux (nutellaboot) — admin/chefe tudo; .cstaff/.staff a própria sede; ?catalog= = catálogo de comandos", "responses": { "200": { "description": "{configured, url, status, can_admin, scoped, data:{version:2, contest, link, global, by_node, sedes[]}} — agregados por recorte (pop, ram_bands, ed_adopt/ed_groups/ed_count/profiles, pressure, rank_ed, series); ver docs/NUTELLABOOT.md" }, "403": { "description": "role_required" } } }, "post": { "tags": [ "contest" ], "summary": "Ações da integração nutellaboot: config (chave write-only)/collect/push-roster (admin) e command (admin ou c/staff na própria sede, fail-closed)", "responses": { "200": { "description": "config:{saved,configured} · collect:{started} · push-roster:{pushed,kept,failed} · command:{sent,op,image,mac,upstream}" }, "403": { "description": "admin_required/site_forbidden/command_scope_required" }, "409": { "description": "not_configured/no_cache" }, "422": { "description": "key_invalid/op_invalid/op_not_allowed/image_invalid" }, "502": { "description": "upstream_error — nutellaboot indisponível" } } } }, "/contest/admin/finish": { "get": { "tags": [ "contest-admin" ], "summary": "Checklist pós-prova (o que ainda está fechado) — admin ou juiz-chefe", "responses": { "200": { "description": "{checks:[{id,level,label,detail}], summary:{ok,warn,fail}, can_finish, can_act (true só p/ o admin — o POST é dele), pending_docs:[{type,lang}]}" }, "403": { "description": "admin_required (nem admin nem juiz-chefe)" } } }, "post": { "tags": [ "contest-admin" ], "summary": "Encerrar evento: abre o placar (FREEZE_TIME=0) e publica os documentos gerados — admin", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "action" ], "properties": { "action": { "type": "string", "enum": [ "finish" ] } } } } } }, "responses": { "200": { "description": "{finished:true, done:[{item,detail}], skipped:[{item,reason}]}" }, "400": { "description": "bad_json/action_invalid" }, "403": { "description": "admin_required" }, "409": { "description": "contest_running — a prova ainda não acabou para todas as sedes" }, "429": { "description": "busy" } } } }, "/contest/admin/report": { "get": { "tags": [ "contest-admin" ], "summary": "Relatório estático da prova (tar.gz navegável offline: placar aberto, runs, enunciados, clarifications anônimas, estatísticas, tarefas do staff, infra)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "application/gzip (relatorio--.tar.gz)" }, "429": { "description": "busy — já existe uma geração em andamento" } } } }, "/contest/news-file": { "get": { "tags": [ "contest" ], "summary": "Baixa o anexo de uma notícia", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "arquivo (octet-stream, Content-Disposition: attachment)" } } } }, "/contest/doc": { "get": { "tags": [ "contest" ], "summary": "Documentos da prova em pt/en/es: lista (sem type) ou download (com type; o PDF enviado pelo admin vence o gerado)", "description": "Sem `type`: lista os documentos que o login pode baixar. Com `type`: serve o arquivo (PDF/HTML). Idiomas pt/en/es. Em fmt=pdf o documento ENVIADO pelo admin (docs/..uploaded.pdf) vence o gerado; fmt=html e sempre o gerado. Admin e juiz-chefe sempre; qualquer outro login so o que estiver PUBLICADO (404 not_published).", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" }, { "name": "type", "in": "query", "schema": { "type": "string", "enum": [ "info-sheet", "contest", "times", "editorial" ] } }, { "name": "lang", "in": "query", "schema": { "type": "string", "enum": [ "pt", "en", "es" ] } }, { "name": "fmt", "in": "query", "schema": { "type": "string", "default": "pdf", "enum": [ "pdf", "html" ] } } ], "responses": { "200": { "description": "{docs:[{type,lang,html_bytes,pdf_bytes,generated_at,by,published}], can_manage} ou o arquivo" }, "404": { "description": "not_published | not_generated" } } } }, "/contest/rounds": { "get": { "tags": [ "contest" ], "summary": "Rodadas do contest (aquecimento / prova oficial) visiveis a este login", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{active, can_manage, rounds:[{slug,name,kind,state,start,end,published,stats,has_report}]}" } } } }, "/contest/round": { "get": { "tags": [ "contest" ], "summary": "Serve o relatorio arquivado de uma rodada (site estatico)", "description": "Admin/juiz/chief/staff/cstaff/mon sempre; demais logins so rodada publicada (404 not_published). O caminho e confinado ao diretorio do relatorio.", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" }, { "name": "round", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "file", "in": "query", "schema": { "type": "string", "default": "index.html" } } ], "responses": { "200": { "description": "o arquivo (HTML/PDF/CSS/JS/imagem)" }, "404": { "description": "not_published | no_report | file_notfound | round_notfound" } } } }, "/contest/resources": { "get": { "tags": [ "contest" ], "summary": "Materiais do contest (opcional)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "ok" } } } }, "/contest/history": { "get": { "tags": [ "contest" ], "summary": "Histórico do usuário (TXT)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "TXT: tempo:user:probid:lang:veredito:epoch:subid — veredito (campo 5) SEMPRE canônico em TODOS os modos (a string com score/grupos fica no disco; o detalhe por modo vem do /submission/summary redigido). Pendentes/strings desconhecidas intactos; sufixo ' (Ignored)' preservado", "content": { "text/plain": {} } } } } }, "/contest/balloons": { "get": { "tags": [ "contest" ], "summary": "Cores de balão por problema", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "mapa letra→cor" } } } }, "/contest/regions": { "get": { "tags": [ "contest" ], "summary": "Regiões p/ filtro do placar", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "ok" } } } }, "/contest/score": { "get": { "tags": [ "contest" ], "summary": "Placar (TXT, 1ª linha = modo); antes do início serve a VITRINE (times sem colunas de problema — o placar nunca revela a quantidade de problemas antes de a competição começar; is_judge vê o completo); privilegiado recebe o completo — view=public força o congelado (usado pela cerimônia de revelação); scope=mine (só .cstaff) recorta à sede", "parameters": [ { "$ref": "#/components/parameters/contest" }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" }, "description": "VISÃO do placar (coortes): public = visão pública/congelada mesmo com sessão privilegiada; oficial = só as coortes públicas; geral = tudo (só p/ quem já pode ver tudo); = o placar paralelo dela (ex.: individual, times) — é público, não exige sessão. Valor inválido cai na visão do login." }, { "name": "scope", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "mine" ] }, "description": "mine (honrado só p/ .cstaff) = recorta o placar servido (frozen e full) aos usuários do escopo dele (staff-filters); fora da allowlist SCORE_FULL_USERS, o full só sai quando o contest terminou p/ TODAS as sedes (fim do conf + maior end de time-overrides.json) — cerimônia por sede" } ], "responses": { "200": { "description": "TXT", "content": { "text/plain": {} } }, "401": { "description": "contest SUPER SECRETO sem sessão do contest (secret_login_required)" } } } }, "/contest/allsubmissions": { "get": { "tags": [ "contest" ], "summary": "Todas as submissões (TXT 9 campos; admin/chief completo; judge/mon ANÔNIMO — username/fullname/univ vazios, ordenado por epoch)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "TXT", "content": { "text/plain": {} } } } } }, "/contest/final-verdicts": { "get": { "tags": [ "contest" ], "summary": "Opções de veredicto manual (judge): {verdicts:[labels], options:[{label,verdict}]}", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "ok" } } }, "post": { "tags": [ "contest" ], "summary": "Grava as opções de veredicto (admin/chief): {options:[{label,verdict}]}", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{saved,options}; 403 config_forbidden" } } } }, "/contest/auto-verdicts": { "get": { "tags": [ "contest" ], "summary": "Matriz de veredicto automático problema×lang×veredicto (judge)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{matrix,problems,verdicts}" } } }, "post": { "tags": [ "contest" ], "summary": "Grava a matriz auto (admin/chief): {matrix:{cid:{lang|*:[verdict]}}}", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{saved,matrix}; 403 config_forbidden" } } } }, "/contest/review/list": { "get": { "tags": [ "contest" ], "summary": "Fila de revisão de veredicto manual (judge; votos detalhados e login do competidor só p/ admin/chief — anti-anchoring/anonimato)", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{manual,options,items,counts:{not_evaluated,being_evaluated,awaiting_second,conflicts},my_active}" } }, "description": "Resposta inclui quorum (REVIEW_JUDGES do contest)." } }, "/contest/review/claim": { "post": { "tags": [ "contest" ], "summary": "Pega/renova/larga avaliação (judge): {id,action:claim|extend|giveup}; máx 2, 1 ativa, TTL 5min", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{updated}; 409 already_evaluating|slots_full" } } } }, "/contest/review/vote": { "post": { "tags": [ "contest" ], "summary": "Vota o veredicto (judge): {id,label}; voto permanente e libera o juiz (pega outra); 2 iguais liberam, 2 diferentes = conflito", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{status,released_verdict?}" } } } }, "/contest/review/resolve": { "post": { "tags": [ "contest" ], "summary": "Juiz-chefe resolve conflito (admin/chief): {id,verdict}", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{status:released,released_verdict}; 403 chief_required" } } } }, "/contest/review/conflicts": { "get": { "tags": [ "contest" ], "summary": "Sumário de conflitos de veredicto p/ o juiz-chefe (admin/chief); n alimenta o alerta global", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{conflicts:[{id,login,problem_id,lang,sub_epoch,computed_verdict,votes}], n, options}" } } } }, "/contest/review/stats": { "get": { "tags": [ "contest" ], "summary": "Estatística por .judge da avaliação manual (admin/chief): votos, tempo médio, concordâncias, conflitos", "security": [ { "bearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{judges:[{judge,votes,avg_response_s,timed,agreements,conflicts}], total:{votes,avg_response_s}}" } } } }, "/contest/set-verdict": { "post": { "tags": [ "contest" ], "summary": "Definir veredicto final (admin ou juiz-chefe)", "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "contest": { "type": "string" }, "problem_id": { "type": "string" }, "verdict": { "type": "string" }, "username": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" } } } }, "/contest/rejudge": { "post": { "tags": [ "contest" ], "summary": "Rejulgar (admin): reconstrói a fonte arquivada + reinjeta como submit", "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "contest": { "type": "string" }, "ids": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "{action:rejudge, queued[], count, skipped[], skipped_count} (skipped = sem fonte/linha no history)" } } } }, "/admin/adduser": { "post": { "tags": [ "admin" ], "summary": "Adicionar usuário", "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "contest": { "type": "string" }, "login": { "type": "string" }, "fullname": { "type": "string" }, "email": { "type": "string" }, "password": { "type": "string" } } } } } }, "responses": { "200": { "description": "{login,password}" } } } }, "/admin/passwd": { "post": { "tags": [ "admin" ], "summary": "Trocar senha", "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "contest": { "type": "string" }, "login": { "type": "string" }, "newpass": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" } } } }, "/admin/contest/extend": { "post": { "tags": [ "admin" ], "summary": "Estender fim do contest", "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "contest": { "type": "string" }, "end_epoch": { "type": "integer" } } } } } }, "responses": { "200": { "description": "ok" } } } }, "/admin/synctreino": { "post": { "tags": [ "admin" ], "summary": "Sincronizar treino", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "ok" } } } }, "/admin/rejudge": { "post": { "tags": [ "admin" ], "summary": "Rejulgar (alias do bot)", "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "contest": { "type": "string" }, "ids": { "type": "array", "items": { "type": "string" } }, "problem": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" } } } }, "/ops/queue": { "get": { "tags": [ "ops" ], "summary": "Tamanho da fila por contest", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "ok" } } } }, "/ops/problemtl": { "get": { "tags": [ "ops" ], "summary": "Time limits de um problema", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "problem", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "ok" } } } }, "/ops/updateproblemset": { "post": { "tags": [ "ops" ], "summary": "Atualizar problemset nos juízes", "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "repo": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" } } } }, "/index/status": { "get": { "tags": [ "index" ], "summary": "Health público (fila, máquinas, daemons)", "responses": { "200": { "description": "{queue,judge:{online,total,busy,healthy,cpus_online,gpus_online},alert,daemons} — cache 20s; gpus_online = só GPU de compute comprovada (nvidia-smi/rocm-smi); daemons.judged = processo local ou heartbeat run/judged.alive (deploy em container) + bot:{alive,last_poll_age_s}|null (mojinho; null = sem bot)" } }, "description": "judge.slots = capacidade total em SLOTS (multi-slot); judge.busy = slots ocupados." } }, "/treino/contest-create/permission": { "get": { "tags": [ "contest-create" ], "summary": "O usuário pode criar contest?", "responses": { "200": { "description": "{can_create,is_admin,reason,solved_count,threshold,in_allow,in_deny,allowed_modes}" } } } }, "/treino/contest-create/problems": { "get": { "tags": [ "contest-create" ], "summary": "Busca no banco público de problemas", "parameters": [ { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "{problems:[{id,title,tags}],total,bank_total}" } } } }, "/treino/contest-create/create": { "post": { "tags": [ "contest-create" ], "summary": "Cria e publica o contest (no ar na hora)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "mode": { "type": "string", "enum": [ "icpc", "obi", "treino", "heuristic", "outro" ] }, "start": { "type": "integer" }, "end": { "type": "integer" }, "priority": { "type": "string", "enum": [ "prova", "lista-privada", "lista-publica", "super" ], "description": "prioridade no escalonador ('super' só admin do treino)" }, "languages": { "description": "array de ids canônicos (normalizado como o settings) ou string legada", "oneOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "string" } ] }, "judges": { "type": "array", "items": { "type": "string" }, "description": "pool de juízes do contest (hostnames do registro; vazio = qualquer juiz online) — vira CONTEST_JUDGES; escalonador ESTRITO" }, "showcode": { "type": "boolean" }, "show_log": { "type": "boolean" }, "show_editor": { "type": "boolean" }, "show_tl": { "type": "boolean" }, "allow_backup": { "type": "boolean" }, "allow_print": { "type": "boolean" }, "score_anon": { "type": "boolean" }, "manual_verdict": { "type": "boolean" }, "allow_late": { "type": "boolean" }, "secret": { "type": "boolean", "description": "SUPER SECRETO: fora das listagens públicas; placar/visual exigem login no contest" }, "login_ua_substring": { "type": "string", "maxLength": 200 }, "score_full_users": { "type": "array", "items": { "type": "string" } }, "penalty_minutes": { "type": "integer", "minimum": 0, "description": "placar ICPC: minutos por tentativa que conta antes do AC (default 20)" }, "penalty_verdicts": { "type": "array", "items": { "type": "string", "enum": [ "wa", "tle", "mle", "rte", "ce" ] }, "description": "placar ICPC: verdicts que contam penalidade (default wa/tle/mle/rte; Judge Error e pendentes nunca contam; [] = nenhum penaliza)" }, "locale": { "type": "string", "enum": [ "pt", "en", "es" ] }, "login_start": { "type": "integer" }, "login_enabled": { "type": "boolean" }, "freeze": { "type": "integer" }, "problems": { "type": "array", "items": { "type": "object", "description": "bank_id OU source+problem_id; name/letter; statement_b64/statement_file, statement_pdf_b64/statement_pdf_file; languages[] por problema (vira problem-langs.json). Ao menos um item — ou allow_empty:true" } }, "allow_empty": { "type": "boolean", "description": "cria o contest SEM problemas (configura depois por /contest/admin/problems). Sem ele, problems[] vazio ⇒ 422 no_problems. Só o booleano true vale (1/\"true\" não)" }, "admin": { "type": "object", "properties": { "login": { "type": "string" }, "password": { "type": "string" }, "fullname": { "type": "string" } } }, "users_from": { "type": "string", "description": "id de contest cujos usuários são compartilhados (ex.: treino)" }, "users": { "type": "array", "items": { "type": "object", "properties": { "login": { "type": "string" }, "password": { "type": "string" }, "fullname": { "type": "string" }, "email": { "type": "string" } } } }, "colors": { "type": "object", "description": "mapa letra->hex (sem #) + enableSonic?" }, "regions": { "type": "array", "items": { "type": "object" } }, "teams_meta": { "type": "array", "items": { "type": "object", "properties": { "regex": { "type": "string" }, "country": { "type": "string" }, "school": { "type": "string" }, "school_full": { "type": "string" } } } } }, "required": [ "name", "end" ] } } } }, "responses": { "200": { "description": "{contest_id,admin_login,admin_reused,admin_password,url,scoreboard_url}" }, "403": { "description": "sem permissão" }, "409": { "description": "id em uso/reservado" }, "422": { "description": "validação (no_problems = problems[] vazio sem allow_empty)" } } } }, "/treino/contest-create/template": { "get": { "tags": [ "contest-create" ], "summary": "Baixa template JSON do contest", "responses": { "200": { "description": "arquivo JSON (attachment)" } } } }, "/treino/contest-create/import": { "post": { "tags": [ "contest-create" ], "summary": "Importa contest de um .tar.gz", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "tar_b64": { "type": "string" } }, "required": [ "tar_b64" ] } } } }, "responses": { "200": { "description": "criado" }, "400": { "description": "tar inválido" } } } }, "/treino/admin/contest-perms": { "get": { "tags": [ "admin" ], "summary": "Lê permissões de criação de contest", "responses": { "200": { "description": "{perms:{threshold,allow[],deny[]}}" } } }, "post": { "tags": [ "admin" ], "summary": "Define permissões de criação de contest", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "threshold": { "type": "integer" }, "allow": { "type": "array", "items": { "type": "string" } }, "deny": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "{saved,perms}" } } } }, "/treino/admin/contests": { "get": { "tags": [ "admin" ], "summary": "Lista contests criados pela interface", "responses": { "200": { "description": "{contests:[{id,name,owner,created_at,mode}],count}" } } } }, "/treino/admin/contest-remove": { "post": { "tags": [ "admin" ], "summary": "Move um contest criado pela interface p/ lixeira", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contest": { "type": "string" } }, "required": [ "contest" ] } } } }, "responses": { "200": { "description": "{removed,contest}" }, "403": { "description": "não criado pela interface" } } } }, "/treino/contest-create/tags": { "get": { "tags": [ "contest-create" ], "summary": "Tags do banco com contagem", "responses": { "200": { "description": "{tags:[{tag,count}],total}" } } } }, "/treino/contest-create/templates": { "get": { "tags": [ "contest-create" ], "summary": "Templates nomeados do criador (?name= => 1; senão lista)", "parameters": [ { "name": "name", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "{templates:[{name,created_at,updated_at,mode,duration,has_problems}]} ou {template:{name,spec}}" }, "404": { "description": "template não encontrado" } } }, "post": { "tags": [ "contest-create" ], "summary": "save|delete|rename template (save: template{} do formulário OU from_contest; spec relativizado + whitelist — nunca guarda usuários/senhas/id)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "op": { "type": "string", "enum": [ "save", "delete", "rename" ] }, "name": { "type": "string", "maxLength": 80 }, "template": { "type": "object" }, "from_contest": { "type": "string", "description": "salvar a partir de contest existente (só dono/admin; senão 404)" }, "include_problems": { "type": "boolean" }, "new_name": { "type": "string" } }, "required": [ "op", "name" ] } } } }, "responses": { "200": { "description": "{saved|deleted|renamed:true}" }, "404": { "description": "template/from_contest não encontrado (não vaza existência)" } } } }, "/treino/contest-create/export": { "get": { "tags": [ "contest-create" ], "summary": "Exporta o spec JSON de um contest (round-trip com o create; nunca exporta passwd/users/senhas)", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "full_statements", "in": "query", "description": "1 = embute todos os enunciados; default embute só o material exclusivo do contest", "schema": { "type": "integer", "enum": [ 0, 1 ] } } ], "responses": { "200": { "description": "attachment -spec.json" }, "404": { "description": "contest inexistente, sem created-by, ou o login não é dono/admin" } } } }, "/treino/contest-create/duplicate": { "post": { "tags": [ "contest-create" ], "summary": "Cria contest novo a partir de existente (conf+problemas+visual; usuários/submissões nunca; datas relativas preservadas)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "from": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "start": { "type": "integer" }, "end": { "type": "integer" }, "admin": { "type": "object" }, "users": { "type": "array", "items": { "type": "object" } }, "users_from": { "type": "string" } }, "required": [ "from" ] } } } }, "responses": { "200": { "description": "mesmo retorno do create" }, "404": { "description": "from inexistente/sem acesso (dono ou admin)" } } } }, "/treino/contest-create/mine": { "get": { "tags": [ "contest-create" ], "summary": "Contests criados pelo login (owner + created-by)", "responses": { "200": { "description": "{contests:[{id,name,mode,created_at,start,end,problems_count}],total}" } } } }, "/treino/contest-create/collections": { "get": { "tags": [ "contest-create" ], "summary": "Coleções do banco público com contagem (escopo do wizard; ≠ /problems/collections)", "responses": { "200": { "description": "{collections:[{collection,count}],total}" } } } }, "/treino/contest-create/genpass": { "get": { "tags": [ "contest-create" ], "summary": "N senhas legíveis", "parameters": [ { "name": "n", "in": "query", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "{passwords[]}" } } } }, "/treino/contest-create/draw": { "get": { "tags": [ "contest-create" ], "summary": "Sorteia problemas por tag, coleção e dificuldade (filtros em AND; reproduzível por seed)", "parameters": [ { "name": "tags", "in": "query", "schema": { "type": "string" } }, { "name": "collections", "in": "query", "description": "array JSON url-encoded de nomes de coleção (casa exato; inválido/ausente = sem filtro)", "schema": { "type": "string" } }, { "name": "count", "in": "query", "schema": { "type": "integer" } }, { "name": "match", "in": "query", "schema": { "type": "string", "enum": [ "any", "all" ] } }, { "name": "difficulty", "in": "query", "schema": { "type": "string", "enum": [ "any", "easy", "medium", "hard", "known" ] } }, { "name": "seed", "in": "query", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "{problems[],candidates,drawn,seed}" } } } }, "/contest/teams-meta": { "get": { "tags": [ "contest" ], "summary": "Regras regex país/escola p/ o placar (bandeiras locais; fallback — o por-usuário /contest/teams vence)", "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{rules:[{regex,country,school,school_full}]}" } } } }, "/contest/teams": { "get": { "tags": [ "contest" ], "summary": "Diretório de TIMES por-usuário p/ o placar (do .team do account.json + assets; secreto exige sessão)", "parameters": [ { "$ref": "#/components/parameters/contest" } ], "responses": { "200": { "description": "{teams:{:{univ_short?,univ_full?,flag?,region?,has_logo,has_photo}}} — o NOME vem do TXT do placar (fullname); precedência: isto > teams-meta > vazio" } } } }, "/contest/team-photo": { "get": { "tags": [ "contest" ], "summary": "Foto do time — PÚBLICA, inclusive em contest secreto (webp; png no acervo antigo; thumb=1 = miniatura de 320px). TIME SEM FOTO devolve a FOTO PADRÃO do contest (200 + header X-MOJ-Photo: placeholder), não 404 — quem precisa saber quem mandou foto usa has_photo das listagens ⚠ em contest SUPER SECRETO o /