Skip to main content

Criação e Gerenciamento de Exercícios

Esta seção detalha os endpoints para criação, atualização, remoção e gerenciamento de exercícios na plataforma FitLocus.

Criar Exercício

Endpoint

Este endpoint permite a criação de um novo exercício com upload opcional de imagem demonstrativa.

Cabeçalhos da Requisição

Parâmetros da Requisição

A requisição deve ser enviada como multipart/form-data com os seguintes campos: O objeto JSON exercise deve conter:

Exemplo de Requisição

Resposta de Sucesso

Código: 201 Created

Respostas de Erro

Código: 400 Bad Request
Código: 400 Bad Request
Código: 401 Unauthorized
Código: 403 Forbidden

Obter Exercício

Endpoint

Este endpoint retorna os detalhes de um exercício específico.

Parâmetros de URL

Cabeçalhos da Requisição

Exemplo de Requisição

Resposta de Sucesso

Código: 200 OK

Respostas de Erro

Código: 401 Unauthorized
Código: 403 Forbidden
Código: 404 Not Found

Atualizar Exercício

Endpoint

Este endpoint permite atualizar um exercício existente com upload opcional de nova imagem demonstrativa.

Parâmetros de URL

Cabeçalhos da Requisição

Parâmetros da Requisição

A requisição deve ser enviada como multipart/form-data com os seguintes campos: O objeto JSON exercise segue a mesma estrutura da criação de exercício.

Exemplo de Requisição

Resposta de Sucesso

Código: 200 OK

Respostas de Erro

Código: 400 Bad Request
Código: 401 Unauthorized
Código: 403 Forbidden
Código: 404 Not Found

Remover Exercício

Endpoint

Este endpoint permite remover um exercício existente.

Parâmetros de URL

Cabeçalhos da Requisição

Exemplo de Requisição

Resposta de Sucesso

Código: 204 No Content

Respostas de Erro

Código: 401 Unauthorized
Código: 403 Forbidden
Código: 404 Not Found
Código: 409 Conflict

Listar Exercícios

Endpoint

Este endpoint retorna uma lista paginada de exercícios com filtros opcionais.

Parâmetros de Consulta

Cabeçalhos da Requisição

Exemplo de Requisição

Resposta de Sucesso

Código: 200 OK

Respostas de Erro

Código: 400 Bad Request

Listar Meus Exercícios

Endpoint

Este endpoint retorna uma lista paginada de exercícios criados pelo usuário autenticado.

Parâmetros de Consulta

Cabeçalhos da Requisição

Exemplo de Requisição

Resposta de Sucesso

Código: 200 OK

Respostas de Erro

Código: 401 Unauthorized

Listar Categorias de Exercícios

Endpoint

Este endpoint retorna a lista de todas as categorias de exercícios disponíveis.

Exemplo de Requisição

Resposta de Sucesso

Código: 200 OK

Implementação no Frontend

Componente de Criação de Exercício

Considerações de Design

A interface de criação e gerenciamento de exercícios do FitLocus segue as diretrizes de design da plataforma:
  • Cores: Fundo escuro (#202020), elementos de destaque em verde (#B4ED00), texto em branco (#F9F9F9)
  • Tipografia: Hanken Grotesk para texto e SUPERINE para títulos
  • Layout: Design minimalista com espaçamento generoso e hierarquia clara
  • Componentes: Campos de formulário com bordas arredondadas, botões com feedback visual ao interagir
Para mais detalhes sobre o design, consulte as diretrizes de marca.

Considerações de Segurança

  1. Validação de Dados: Todos os dados de entrada são validados tanto no frontend quanto no backend para prevenir injeção de dados maliciosos.
  2. Controle de Acesso: Verificações rigorosas garantem que um usuário só possa acessar e modificar seus próprios exercícios ou exercícios públicos.
  3. Validação de Arquivos: Uploads de imagem são validados quanto ao tipo, tamanho e conteúdo para prevenir ataques.
  4. Sanitização de Dados: Todos os dados de entrada são sanitizados antes de serem armazenados ou exibidos.
  5. HTTPS: Todas as comunicações com a API devem ser realizadas através de HTTPS para proteger dados sensíveis durante a transmissão.

Troubleshooting

Problemas Comuns

  1. “Formato de arquivo inválido”: Certifique-se de que a imagem está em um dos formatos permitidos (JPG, PNG, GIF).
  2. “Tamanho máximo de arquivo excedido”: Reduza o tamanho da imagem para menos de 5MB.
  3. “Acesso negado”: Verifique se você está tentando atualizar ou remover um exercício que você criou.
  4. “Não é possível remover este exercício”: O exercício está sendo utilizado em treinos. Remova-o dos treinos primeiro.

Depuração

Para depurar problemas com exercícios:
  1. Verifique os logs do console para mensagens de erro detalhadas
  2. Utilize ferramentas como o Postman para testar os endpoints diretamente
  3. Verifique se o token JWT está sendo enviado corretamente no cabeçalho Authorization
  4. Confirme que os dados enviados estão no formato correto e dentro dos limites permitidos