API de equipes

A API Teams permite criar e gerenciar grupos de equipes para competições baseadas em equipes. Equipes são grupos de usuários que competem juntos como uma única unidade.

Visão geral

Os grupos de equipe no omegaUp permitem:

• Competições em equipe: vários usuários resolvendo problemas juntos
• Tamanho da equipe configurável: 1 a 10 competidores por equipe
• Gerenciamento de identidade da equipe: cada equipe tem sua própria identidade

Pontos finais do grupo de equipe

Criar grupo de equipe

Cria um novo grupo de equipe. O usuário autenticado se torna o administrador.

POST /api/teamsGroup/create/

Parâmetros:

Resposta:

{
  "status": "ok"
}

Atualizar grupo de equipe

Atualiza um grupo de equipe existente.

POST /api/teamsGroup/update/

Parâmetros:

Privilégios: Administrador do grupo da equipe

Obtenha detalhes do grupo da equipe

Retorna informações detalhadas sobre um grupo de equipe.

GET /api/teamsGroup/details/

Parâmetros:

Resposta:

{
  "team_group": {
    "create_time": 1609459200,
    "alias": "icpc-team-2024",
    "name": "ICPC Team 2024",
    "description": "Our ICPC competitive team"
  }
}

Listar grupos de equipes

Retorna grupos de equipes que correspondem a uma consulta de pesquisa.

GET /api/teamsGroup/list/

Parâmetros:

Resposta:

[
  {
    "key": "icpc-team-2024",
    "value": "ICPC Team 2024"
  }
]

Listar equipes no grupo

Retorna todas as equipes (identidades) em um grupo de equipes.

GET /api/teamsGroup/teams/

Parâmetros:

Resposta:

{
  "identities": [
    {
      "username": "team:icpc-team-2024:alpha",
      "name": "Team Alpha",
      "country": "MX",
      "school": "University"
    }
  ]
}

Remover equipe

Remove uma equipe de um grupo de equipes.

POST /api/teamsGroup/removeTeam/

Parâmetros:

Privilégios: Administrador do grupo da equipe

Pontos finais dos membros da equipe

Adicionar membros à equipe

Adiciona um ou mais usuários a uma equipe específica.

POST /api/teamsGroup/addMembers/

Parâmetros:

Resposta:

{
  "status": "ok"
}

Erros:

• teamMemberUsernameInUse: O membro já está em uma equipe

Remover membro da equipe

Remove um membro de uma equipe.

POST /api/teamsGroup/removeMember/

Parâmetros:

Privilégios: Administrador do grupo da equipe

Listar membros da equipe

Retorna todos os membros de todas as equipes de um grupo de equipes.

GET /api/teamsGroup/teamsMembers/

Parâmetros:

Resposta:

{
  "pageNumber": 1,
  "totalRows": 15,
  "teamsUsers": [
    {
      "username": "user1",
      "name": "User One",
      "team_alias": "alpha",
      "team_name": "Team Alpha",
      "classname": "user-rank-expert",
      "isMainUserIdentity": true
    }
  ]
}

Formato de nome de usuário da equipe

As equipes têm um formato de nome de usuário especial:

team:{team_group_alias}:{team_name}

Este nome de usuário é usado para: - Faça login como equipe - Referência da equipe em chamadas de API - Exibição em placares

Configuração

Limites de tamanho da equipe

• Tamanho padrão da equipe: 3 competidores
• Tamanho máximo da equipe: 10 competidores
• O tamanho da equipe é configurado por grupo de equipe

Casos de uso

Configurando uma competição estilo ICPC

# 1. Create team group with 3-person teams
curl -X POST https://omegaup.com/api/teamsGroup/create/ \
  -d "alias=icpc-regionals-2024&name=ICPC Regionals 2024&description=Regional contest&numberOfContestants=3"

# 2. Teams are created via bulk upload or identity management

# 3. Add members to a team
curl -X POST https://omegaup.com/api/teamsGroup/addMembers/ \
  -d "team_group_alias=team:icpc-regionals-2024:mit-alpha&usernames=alice,bob,charlie"

# 4. Use contest API to create contest and add team group

Documentação Relacionada

• API de grupos - Para grupos de usuários regulares
• API de concursos - Criação de concursos de equipe
• Autenticação - Fluxo de login da equipe

Referência completa

Para obter detalhes completos do endpoint, consulte o código-fonte do TeamsGroup Controller.