Exercícios

Consulte o catálogo completo de exercícios disponíveis para montar programas de treino. A API retorna exercícios específicos da sua academia combinados com o catálogo global do OctaGym.

Listar Exercícios

GET /api/v1/exercises

Retorna a lista de exercícios filtrados por diversos critérios, ordenados por nome.

Parâmetros de Query

Parâmetro	Tipo	Descrição
`search`	`string`	Busca por nome (`name`) ou nome em inglês (`name_en`)
`muscle_group`	`string`	Filtra por grupo muscular principal
`equipment`	`string`	Filtra por equipamento necessário
`difficulty`	`string`	Filtra por dificuldade: `beginner`, `intermediate` ou `advanced`
`exercise_type`	`string`	Filtra por tipo de exercício
`page`	`int`	Número da página (padrão: 1)
`limit`	`int`	Itens por página (padrão: 20, máximo: 100)

Exemplo de Requisição

curl -X GET "https://dashboard.octagym.ai/api/v1/exercises?muscle_group=chest&difficulty=intermediate&limit=10" \
  -H "Authorization: Bearer og_live_sua_chave_aqui" \
  -H "Content-Type: application/json"

const response = await fetch(
  'https://dashboard.octagym.ai/api/v1/exercises?muscle_group=chest&difficulty=intermediate&limit=10',
  {
    headers: {
      'Authorization': 'Bearer og_live_sua_chave_aqui',
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();

Exemplo de Resposta

{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Supino Reto com Barra",
      "name_en": "Barbell Bench Press",
      "description": "Exercício composto para desenvolvimento do peitoral.",
      "instructions": "Deite no banco, segure a barra na largura dos ombros, desça até o peito e empurre para cima.",
      "muscle_groups": ["chest"],
      "secondary_muscle_groups": ["triceps", "shoulders"],
      "equipment": ["barbell", "bench"],
      "difficulty": "intermediate",
      "exercise_type": "strength",
      "movement_pattern": "horizontal_push",
      "video_url": "https://cdn.octagym.ai/exercises/bench-press.mp4",
      "thumbnail_url": "https://cdn.octagym.ai/exercises/bench-press.jpg"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Crucifixo com Halteres",
      "name_en": "Dumbbell Fly",
      "description": "Exercício de isolamento para o peitoral.",
      "instructions": "Deite no banco segurando halteres com os braços estendidos. Abra os braços em arco e retorne.",
      "muscle_groups": ["chest"],
      "secondary_muscle_groups": ["shoulders"],
      "equipment": ["dumbbells", "bench"],
      "difficulty": "intermediate",
      "exercise_type": "strength",
      "movement_pattern": "horizontal_push",
      "video_url": null,
      "thumbnail_url": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 24,
    "pages": 3
  }
}

Campos do Exercício

Campo	Tipo	Descrição
`id`	`uuid`	Identificador único
`name`	`string`	Nome em português
`name_en`	`string`	Nome em inglês
`description`	`string`	Descrição do exercício
`instructions`	`string`	Instruções de execução
`muscle_groups`	`string[]`	Grupos musculares principais
`secondary_muscle_groups`	`string[]`	Grupos musculares secundários
`equipment`	`string[]`	Equipamentos necessários
`difficulty`	`string`	`beginner`, `intermediate` ou `advanced`
`exercise_type`	`string`	Tipo do exercício (ex: `strength`, `cardio`)
`movement_pattern`	`string`	Padrão de movimento (ex: `horizontal_push`, `pull`)
`video_url`	`string`	URL do vídeo demonstrativo (pode ser `null`)
`thumbnail_url`	`string`	URL da imagem thumbnail (pode ser `null`)

Os exercícios retornados incluem tanto os cadastrados pela sua academia quanto o catálogo global do OctaGym, ordenados por nome.

Grupos Musculares

Valores comuns para o parâmetro muscle_group:

Valor	Descrição
`chest`	Peitoral
`back`	Costas
`shoulders`	Ombros
`biceps`	Bíceps
`triceps`	Tríceps
`quadriceps`	Quadríceps
`hamstrings`	Posteriores
`glutes`	Glúteos
`calves`	Panturrilhas
`abs`	Abdominais
`forearms`	Antebraços

Suporte

Email: suporte@octagym.ai
Dashboard: dashboard.octagym.ai

Exercícios

On this page