Você tem um ID de exercício em seu aplicativo esportivo e precisa obter dados concretos de treinamento agora mesmo: movimentos alternativos, séries e repetições de hoje para um programa, ou um índice rápido de partes do corpo para impulsionar sua interface. Ao final deste guia, você será capaz de buscar alternativas de exercícios por ID, iniciar um programa personalizado e obter o treino de hoje usando a API do Banco de Dados de Exercícios no Zyla API Hub.
O que esta API oferece (e onde se encaixa em um aplicativo esportivo)
A API do Banco de Dados de Exercícios fornece:
- Alternativas de exercícios por ID, filtradas para equipamentos quando necessário (ótimo para lógica de substituição quando certos equipamentos não estão disponíveis).
- Criação de programas que retornam a sessão de hoje: exercícios, séries, repetições, descanso e campos de peso sugerido.
- Obtenção do treino de hoje para um programa existente.
- Uma lista simples de partes do corpo para estruturar filtros ou navegação no aplicativo.
Esses endpoints permitem construir rapidamente fluxos de trabalho de substituição (por exemplo, “mostre-me movimentos como este”), gerar ou atualizar sessões de treinamento diárias e apresentar agrupamentos lógicos de catálogo (por parte do corpo) — fluxos principais em aplicativos de treinamento esportivo, painéis de coaching e experiências de ecommerce de fitness ligadas à disponibilidade de equipamentos.
Começando no Zyla API Hub
Abra a página da API, clique em Inscrever-se (ou Iniciar Teste Gratuito se disponível) e obtenha sua chave. A autenticação é via cabeçalho Authorization: Bearer SUA_CHAVE_API. A cobrança é por assinatura + cota (não por chamada). Para esta API, você pode começar com um teste de 7 dias a partir da página de listagem. Mantenha sua chave segura; não a comprometa no controle de versão.
Você pode explorar milhares de integrações prontas para produção em esportes e saúde no Zyla API Hub, tudo sob uma conta, uma chave API e um modelo de assinatura consistente em todas as categorias. Quando estiver pronto para esta integração, use o link de listagem direta abaixo para criar uma conta e obter sua chave API.
Iniciar teste de 7 dias na API do Banco de Dados de Exercícios
Endpoints que você usará
1) Alternativas de Exercício (GET)
Até 10 exercícios com o mesmo movimento do ID de exercício fornecido. Se esse exercício não tiver movimento, a API recorre ao mesmo músculo alvo. Você pode opcionalmente restringir os resultados a um equipamento específico.
- Método: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives
- Parâmetro de consulta obrigatório: id (número)
- Parâmetro de consulta opcional: equipment (string)
Curl copiável:
curl -s -X GET "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts" \
-H "Authorization: Bearer SUA_CHAVE_API"Resposta de exemplo oficial (verbatim):
[{"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":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_5.gif","id":5,"name":"alternate heel touchers","target":"abs","videos":[{"title":"Alternating Heel Touch | Bodyweight Home Workout Exercise","link":"https://youtu.be/5JyOU0smtMo"},{"title":"How To Do…O que usar:
- id: o ID do exercício relacionado (use-o para link profundo ou buscar detalhes em seu aplicativo).
- name, bodyPart, target: rótulos para cartões de UI ou chips de filtragem.
- equipment: restrinja alternativas ao equipamento disponível na academia ou em casa.
- gifUrl e videos: mídias para guiar a forma e a técnica.
2) Criar Programa (POST)
Inicie um programa e obtenha imediatamente a sessão de hoje. Você pode definir uma rotina predefinida (por exemplo, muscle_gain_4 ou weight_loss_3). Forneça o identificador do seu cliente em client_id para mapear sessões ao seu objeto de usuário.
- Método: POST
- URL: https://zylalabs.com/api/392/exercise-database-api/34185/create-program
- Campo de corpo obrigatório: request_body (JSON em string)
Curl copiável (note que o JSON é passado como uma string dentro de request_body):
Resposta de exemplo oficial (verbatim):
[
"waist",
"upper legs",
"back",
"lower legs",
"chest",
"upper arms",
"cardio",
"shoulders",
"lower arms",
"neck"
]O que usar:
- program_id e program_key: persista esses para buscar sessões futuras.
- session.exercises[] campos: renderize o plano de hoje, incluindo séries, reps_min/reps_max, rest_seconds e weight_kg (quilogramas; pode ser nulo inicialmente).
- progression e why: mostre prompts de coaching (por exemplo, o que ajustar ou registrar a seguir).
3) Treino de Hoje (GET)
Busque a sessão de hoje para um programa armazenado. Use o program_id e program_key que você obteve ao Criar Programa.
- Método: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout
- Parâmetros de consulta obrigatórios: program (número), program_key (string)
Curl copiável:
Resposta de exemplo oficial (verbatim):
O que usar:
- week, deload, comeback: exiba o contexto de treinamento (por exemplo, semanas de volume reduzido).
- exercises[] com sets/reps/rest: impulsione sua UI de sessão e rastreamento.
- weight_kg e estimated_1rm_kg: suporte recomendações de carga ou gráficos quando disponíveis.
4) Lista de Partes do Corpo (GET)
Um pequeno endpoint utilitário para semear filtros e navegação em sua UI de treinamento esportivo.
- Método: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts
AMOSTRA OFICIAL (verbatim):
Caso de uso: renderize um menu de facetas ou dropdown que corresponda à forma como a API categoriza os exercícios, para que os usuários possam filtrar rapidamente o conteúdo de treinamento esportivo relevante.
Um exemplo de código funcional (Python) para alternativas de “exercício por ID”
Este script chama Alternativas de Exercício usando um ID de exercício e um filtro de equipamento opcional, e então imprime uma lista compacta que sua UI pode consumir. Ele usa o endpoint exato e os campos mostrados acima.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "SUA_CHAVE_API")
BASE_URL = "https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives"
def get_alternatives(exercise_id, equipment=None):
params = {"id": exercise_id}
if equipment:
params["equipment"] = equipment
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get(BASE_URL, headers=headers, params=params, timeout=20)
r.raise_for_status()
return r.json()
if __name__ == "__main__":
# Exemplo: alternativas para exercício id=1, filtradas para barra
data = get_alternatives(1, equipment="barbell")
# Renderize um resumo mínimo por exercício
for ex in data:
print(f"[{ex.get('id')}] {ex.get('name')} - {ex.get('target')} ({ex.get('equipment')})")
vids = ex.get("videos", [])[:2]
for v in vids:
print(f" - {v.get('title')}: {v.get('link')}")
print()Notas:
- A autenticação é apenas via cabeçalho: Authorization: Bearer SUA_CHAVE_API.
- Não há paginação especificada para este endpoint; ele retorna até 10 itens.
- gifUrl e videos são campos de mídia opcionais para exibir em sua UI de coaching.
Detalhes práticos de integração que economizam tempo
- Autenticação: Todas as chamadas requerem Authorization: Bearer SUA_CHAVE_API. Mantenha-a fora do código do lado do cliente, se possível.
- Unidades: os campos weight_kg estão em quilogramas; rest_seconds está em segundos; reps são inteiros com campos min/max.
- Cache: Listas estáticas (como partes do corpo) são boas candidatas para cache diário. Alternativas dependem do exercício semente e do equipamento; faça cache por par (id, equipment) para um TTL curto se seu aplicativo carregar isso com frequência durante uma sessão de treino.
- Mídia: gifUrl e videos[].link são adequados para exibição no cliente. Lide com a possibilidade de que weight_kg e estimated_1rm_kg possam ser nulos no início de um novo programa.
- Programas: Persista tanto program_id quanto program_key. Você precisará de ambos para buscar o treino de hoje de forma confiável.
- Cotas: O hub funciona com assinatura + cota (não por chamada). Para a primeira API, você pode usar um teste de 7 dias ou 50 solicitações para avaliar. Verifique a listagem para opções de acesso e preços atuais.
Casos de uso de aplicativos esportivos no mundo real
- Substituições em tempo real: Se um suporte estiver ocupado, chame Alternativas de Exercício com o id do exercício original e o equipamento disponível para mostrar 3–5 trocas viáveis com o mesmo movimento ou músculo alvo.
- Sessões programadas: Inicie o plano de um novo atleta com Criar Programa e renderize a sessão retornada imediatamente, incluindo séries, repetições e descanso.
- Tela de plano diário: A cada dia, busque o Treino de Hoje para exibir a próxima sessão, respeitando as bandeiras de deload ou comeback para contexto.
- Filtros de catálogo: Use a lista de partes do corpo para implementar filtros de navegação que correspondam à taxonomia da API, mantendo a busca sincronizada com os dados subjacentes.
Chamando a API do Banco de Dados de Exercícios de um agente de IA (MCP)
Você pode executar esses endpoints de qualquer cliente compatível com MCP (por exemplo, Claude Code, Cursor, Windsurf) apontando o cliente para o endpoint MCP e fornecendo sua chave.
- Endpoint MCP: MCP
- Chave: apikey=SUA_CHAVE_API
Do seu agente, você pode instruí-lo a realizar um GET na URL de Alternativas de Exercício com id=1 e equipment=barbell, ou a POST para Criar Programa com o payload request_body em string. Isso é útil para semi-automatizar fluxos de trabalho de coaching, como “construir o dia de empurrão de hoje e substituir quaisquer levantamentos apenas com barra por alternativas com halteres.”
Exemplo de fluxo de trabalho: construir uma sessão ciente de substituições
- Crie um programa via Criar Programa e armazene program_id e program_key em sua tabela de usuários.
- Chame o Treino de Hoje a cada dia para listar exercícios com séries/repetições/descanso.
- Quando o usuário tocar em “Encontrar alternativa”, chame Alternativas de Exercício com o id do exercício de origem e o equipamento atual do usuário (por exemplo, “barra” ou “peso corporal”).
- Troque o cartão na UI da sessão, preservando séries/repetições/descanso prescritos, e exiba gifUrl ou vídeos para guiar o atleta.
Outra referência rápida: Taxonomia de partes do corpo
Você provavelmente precisa de uma taxonomia simples e estável para filtros de treinamento esportivo. Use o endpoint oficial “Lista de Partes do Corpo” para impulsionar sua UI, como mostrado acima. Manter suas opções de filtro idênticas à lista da API ajuda a evitar incompatibilidades entre entradas de pesquisa e metadados de exercícios.
Exemplo oficial: curl e JSON para partes do corpo
Para completar, aqui está a amostra oficial novamente em um só lugar para copiar rapidamente durante a configuração:
FAQ
Como eu me autentico?
Envie Authorization: Bearer SUA_CHAVE_API em cada solicitação.
Posso obter exercícios semelhantes a um ID específico?
Sim. Use Alternativas de Exercício com o parâmetro de consulta id, e opcionalmente equipment para restringir os resultados.
Como eu busco o treino de hoje para um usuário?
Crie um programa com Criar Programa para obter program_id e program_key. Em seguida, chame o Treino de Hoje com ambos os parâmetros para recuperar a sessão atual.
Quais unidades são usadas para pesos e descanso?
Pesos estão em quilogramas (weight_kg). O descanso está em segundos (rest_seconds).
Há um plano gratuito?
Esta API funciona com assinatura + cota com um teste de 7 dias disponível a partir da listagem. Verifique a página da API para opções de acesso e preços atuais.
Pronto para integrar fluxos de “exercício por ID” em seu aplicativo esportivo? Crie sua conta e inicie o teste de 7 dias na página de listagem: API do Banco de Dados de Exercícios. Você estará funcionando com substituições, programas e sessões diárias em minutos.
