Você precisa de uma API para listar as partes do corpo que seu aplicativo suporta, para que os usuários possam navegar por exercícios por região (peito, costas, ombros, etc.). Ao final deste guia, você fará essa chamada em uma única requisição, integrará isso à sua interface e verá como puxar exercícios relacionados e sessões completas de treino da mesma fonte.
O que esta API oferece
A API do Banco de Dados de Exercícios no Zyla API Hub retorna dados estruturados de fitness que você pode implementar rapidamente. Inclui:
- Uma lista canônica de partes do corpo para alimentar filtros e navegação.
- Alternativas de exercícios com o mesmo movimento ou músculo alvo.
- Criação de programas que resultam em uma sessão pronta para execução (séries, repetições, descanso, músculos alvo e links de mídia).
- Consulta do treino de hoje para um programa existente.
É comumente usada para construtores de treino, fluxos de integração de fitness, painéis de coaching e interfaces de descoberta de exercícios.
Começando no Zyla API Hub
O Zyla API Hub centraliza mais de 10.000 APIs públicas com uma conta, uma chave de API e um modelo de assinatura + cota (não é pago por chamada). Para a API do Banco de Dados de Exercícios, você pode iniciar um teste de 7 dias ou uma cota de requisições limitada para avaliação. Não há Plano Gratuito; verifique a página da API para opções de acesso e preços atuais.
Para começar:
- Abra a página da API do Banco de Dados de Exercícios e inscreva-se: Iniciar teste de 7 dias na API do Banco de Dados de Exercícios.
- Copie sua chave de API.
- Chame os endpoints usando Authorization: Bearer YOUR_API_KEY.
Endpoint: Lista de Partes do Corpo
Recupere o conjunto canônico de partes do corpo para preencher dropdowns, abas ou navegação. Nenhum parâmetro é necessário.
Método HTTP: GET
URL da requisição: https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts
exemplo curl
curl -s -X GET "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts" \
-H "Authorization: Bearer YOUR_API_KEY"Resposta real
[
"cintura",
"pernas superiores",
"costas",
"pernas inferiores",
"peito",
"braços superiores",
"cardio",
"ombros",
"braços inferiores",
"pescoço"
]Você normalmente mapeará essas strings para rótulos localizados em seu aplicativo e as usará como chaves para filtrar a busca de exercícios ou direcionar para visualizações detalhadas.
exemplo Python
Este trecho recupera a lista e a prepara para exibição na interface. Substitua YOUR_API_KEY antes de executar.
import requests
API_KEY = "YOUR_API_KEY"
URL = "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts"
resp = requests.get(URL, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=20)
resp.raise_for_status()
body_parts = resp.json() # list[str]
# Exemplo: normalizar e classificar para exibição
ui_items = [{"key": bp, "label": bp.title()} for bp in body_parts]
ui_items.sort(key=lambda x: x["label"])
print("Partes do corpo disponíveis:")
for item in ui_items:
print(f"- {item['label']}")Endpoint: Alternativas de Exercícios
Retorne até 10 exercícios que correspondem ao mesmo movimento; se nenhum, eles compartilham o mesmo músculo alvo. Útil para sugestões de troca em um construtor de treino.
Método HTTP: GET
URL da requisição: https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives
Parâmetros:
- id (número, obrigatório): 1
- equipment (string, opcional): barra
exemplo curl
Exemplo de resposta
[{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_2.gif","id":2,"name":"45\u00b0 side bend","target":"abs","videos":[{"title":"45 degree side bends","link":"https://youtu.be/pUXu_7H0y_o"},{"title":"Side Bend on 45-degree Hyper Extension - Bodyweight or Weighted","link":"https://youtu.be/IyCX-a9Lm_U"},{"title":"Dumbbell Side Bend - Core / Abs - Bodybuilding.com","link":"https://youtu.be/UUQHeBRE_Wo"}]},{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_3.gif","id":3,"name":"air bike","target":"abs","videos":[{"title":"Air Bike - Ab Exercises - Bodybuilding.com","link":"https://youtu.be/i6mPCVUrtNk"},{"title":"Air Bike Crunches","link":"https://youtu.be/3K9hMlalr60"},{"title":"Air cycling","link":"https://youtu.be/oyXoWU8j310"}]},{"bodyPart":"cintura","equipment":"peso do corpo","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_5.gif","id":5,"name":"toques alternados no calcanhar","target":"abs","videos":[{"title":"Alternating Heel Touch | Bodyweight Home Workout Exercise","link":"https://youtu.be/5JyOU0smtMo"},{"title":"Como Fazer…Campos principais que você usará:
- id, name: identificadores primários para seu DB ou UI.
- bodyPart, target: impulsionam a categorização e a marcação de músculos.
- equipment: controla substituições com base no equipamento disponível.
- gifUrl, videos: melhoram a experiência do usuário com orientações visuais.
Endpoint: Criar Programa
Inicie um programa e obtenha a sessão de hoje imediatamente. Forneça uma rotina predefinida ou um objetivo. A resposta inclui metadados da sessão e exercícios com séries/repetições/descanso.
Método HTTP: POST
URL da requisição: https://zylalabs.com/api/392/exercise-database-api/34185/create-program
Parâmetros:
- request_body (string, obrigatório): {"client_id":"member-1","routine":"muscle_gain_4"}
exemplo curl
Exemplo de resposta
Persistir program_id e program_key para o membro. Use a sessão incorporada para renderizar o plano de hoje sem outra requisição.
Endpoint: Treino de Hoje
Recupere a sessão de hoje para um programa existente. Retorna exercícios com séries, intervalos de repetições e orientações de descanso. Use isso para retomar o treinamento na web ou no mobile após a criação inicial do programa.
Método HTTP: GET
URL da requisição: https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout
Parâmetros:
- program (número, obrigatório): 1
- program_key (string, obrigatório): aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
exemplo curl
Exemplo de resposta
Campos importantes:
- week, day_name: contexto de exibição para a sessão.
- exercises[].sets, reps_min, reps_max, rest_seconds: prescrição central para volume de treinamento e ritmo.
- exercises[].weight_kg pode ser nulo inicialmente; definir após o registro do usuário.
Padrões do mundo real que são rápidos
- Integração: chame a Lista de Partes do Corpo para renderizar chips selecionáveis. Persista as áreas de foco do usuário para personalizar sugestões de exercícios.
- Interface de troca: quando um usuário toca em “Trocar”, chame Alternativas de Exercícios com o id do exercício atual e, opcionalmente, o equipamento disponível para garantir substituições viáveis.
- Programa instantâneo: POST Criar Programa após a integração, então mostre a sessão retornada imediatamente. Armazene program_id/program_key no perfil do usuário.
- Retorno diário: ao abrir o aplicativo, chame o Treino de Hoje com program e program_key para continuar de onde pararam.
- Apoio visual: exiba gifUrl ou o primeiro link de vídeo ao lado de cada exercício para reduzir confusão e apoiar a forma correta.
Notas de implementação prática
- Autenticação: envie Authorization: Bearer YOUR_API_KEY em cada requisição.
- Cache: A Lista de Partes do Corpo é estável. Armazene em cache por horas ou dias para reduzir latência e evitar chamadas extras.
- Peso nulo: Muitos campos de força começam como nulos até que um usuário registre carga; trate isso com cuidado e mostre strings de orientação como “Escolha um peso que caia na faixa de repetições.”
- Mídia: gifUrl e vídeos fornecem referências visuais rápidas; pré-carregue os GIFs no Wi‑Fi para uma experiência mais suave.
- Assinaturas: a cobrança é por assinatura + cota. O primeiro acesso à API geralmente inclui um teste de 7 dias ou 50 requisições para avaliação; verifique os detalhes na página de listagem antes de testar carga.
Chamando de um agente de IA via MCP
Se você está orquestrando tarefas com um agente de codificação de IA, pode expor esta API através do endpoint MCP da Zyla. O servidor MCP está disponível em https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY e funciona com clientes compatíveis com MCP como Claude Code, Cursor e Windsurf. Veja a documentação em MCP. Uma vez conectado, seu agente pode invocar os mesmos endpoints da API do Banco de Dados de Exercícios com sua chave de API gerenciada com segurança pela camada MCP.
Tratamento de erros e resiliência
- Validação de entrada: para Alternativas de Exercícios, certifique-se de que o id é um identificador numérico válido e passe o equipamento apenas quando realmente pretende filtrar por ele.
- Timeouts: use timeouts do lado do cliente (por exemplo, 10–20s) e tentativas para erros de rede transitórios.
- Fallbacks graciosos: se o Treino de Hoje não estiver disponível (program/program_key ausentes), direcione os usuários para Criar Programa e, em seguida, prossiga com a sessão retornada.
Exemplo de fiação de ponta a ponta
Fluxo
- Recupere partes do corpo uma vez e renderize como abas: cintura, pernas superiores, costas, pernas inferiores, peito, braços superiores, cardio, ombros, braços inferiores, pescoço.
- Na seleção do usuário, permita que eles criem um programa (por exemplo, muscle_gain_4). Armazene program_id e program_key.
- Carregue a sessão de hoje e exiba as prescrições: séries, intervalos de repetições e descanso.
- Ofereça “Trocar exercício.” Quando tocado, chame Alternativas de Exercícios para mostrar opções compatíveis, filtrando pelo equipamento disponível, se aplicável.
Segurança, chaves e ambientes
- Nunca codifique sua chave de API no cliente; faça chamadas através do seu backend ou use injeção segura de ambiente em builds móveis.
- Configuração de escopo por ambiente (dev/staging/prod) para que sua equipe possa testar contra uma cota de assinatura separada, se necessário.
Perguntas Frequentes
-
Posso obter uma lista de partes do corpo sem filtros?
Sim. Chame GET https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts com seu cabeçalho de Autorização. Ele retorna um array de strings.
-
Como encontro substitutos para um determinado exercício?
Use GET https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives com o parâmetro id obrigatório e, opcionalmente, o equipamento para refinar os resultados.
-
Como gero um plano de treino para um usuário?
POST para https://zylalabs.com/api/392/exercise-database-api/34185/create-program com uma string request_body contendo pelo menos client_id e rotina. Persista o program_id e program_key retornados.
-
Como carrego o treino do dia atual para um programa existente?
Chame GET https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout com program e program_key. Você receberá exercícios, séries, intervalos de repetições, descanso e mídia.
-
Quais são os preços e termos de teste?
A API do Banco de Dados de Exercícios usa um modelo de assinatura + cota. O primeiro acesso à API geralmente inclui um teste de 7 dias ou 50 requisições para avaliação. Verifique a página da API para opções de acesso e preços atuais.
Pronto para conectar sua interface a uma lista confiável de partes do corpo e implementar recursos ricos em exercícios esta semana? Inscreva-se agora e obtenha sua chave na listagem do marketplace: Iniciar teste de 7 dias na API do Banco de Dados de Exercícios.
