🧬 Musculo Eskeletal API

📖 Descrição

A Musculo Eskeletal API oferece acesso a informações estruturadas sobre o sistema musculoesquelético humano. Esta API é projetada para aplicações que requerem dados sobre músculos, articulações, movimentos e relações entre eles, como sistemas de anatomia, biomecânica ou plataformas de educação médica.

🚀 Principais recursos

Através dos endpoints disponíveis, você pode:

🔹 Listar todas as articulações (/joints)
🔹 Consultar os movimentos possíveis (/movements)
🔹 Obter uma hierarquia de grupos musculares e suas porções (/muscles)
🔹 Acessar o mapeamento entre músculos, movimentos e articulações (/muscles/movement-map)
🔹 Consultar porções musculares isoladas (/muscles/portions)
🔹 Listar apenas os grupos musculares (/muscles/groups)

⚙️ Informações técnicas

Versão: 1.0
Base URL: https://gymapi.kadu.tec.br/api/v1
Formato de dados: JSON (application/json)

Status de resposta padrão:

200 OK: Requisição bem-sucedida
304 Not Modified: ETag igual, sem necessidade de retornar conteúdo
404 Not Found: Recurso não encontrado
500 Internal Server Error: Erro inesperado no servidor

📦 Cache e ETag

As respostas dos endpoints GET são cacheáveis por até 1 semana.
A API suporta o uso do cabeçalho If-None-Match com base no valor de ETag. Caso o ETag enviado seja igual ao conteúdo atual, o servidor responderá com 304 Not Modified e nenhum conteúdo no body.

🧩 Estrutura de resposta padrão

Todas as respostas seguem o formato:

{
  "status": "success",
  "data": [...],
  "metadata": {
    "total_itens": 123
  }
}

🔍 Filtros disponíveis (exemplo: `/muscles/movement-map`)

Você pode utilizar filtros de query string para personalizar a busca:

muscle_group: Filtrar por grupo muscular
muscle_portion: Filtrar por porção muscular
joint: Filtrar por articulação
movement: Filtrar por movimento

🔐 Autenticação

Para utilizar os endpoints da Musculo Eskeletal API, é necessário estar autenticado com um token de acesso. Siga os passos abaixo para gerar e usar seu token:

Faça login com sua conta do GitHub utilizando o botão "Login com GitHub" no topo da página.
Após o login, você será redirecionado ao Dashboard.
No dashboard, clique no botão 📋 Copiar token.
⚠️ O token será exibido apenas uma vez. Copie e salve com segurança.
Utilize seu token nas requisições como no exemplo abaixo:

curl --location 'https://gymapi.kadu.tec.br/api/v1/muscles/groups' \
--header 'If-None-Match: "aa450bb55d5a1318432d6b50817fa6fe"' \
--header 'Authorization: Bearer {SEU TOKEN!!}'

Substitua o valor do token pelo que foi gerado para a sua conta.