@vtrack/sdk
O SDK oficial do Vtrack. Acesse dados de treino, eventos da plataforma e posts públicos diretamente nas suas aplicações.
SDK em desenvolvimento ativo
O @vtrack/sdk ainda não foi publicado no npm. A API pública pode mudar antes do lançamento oficial. Acompanhe o progresso e deixe seu feedback através do nosso canal de devs.
O que é o @vtrack/sdk?
O @vtrack/sdk é a biblioteca oficial desenvolvida pelo time do Vtrack para permitir que desenvolvedores integrem funcionalidades da plataforma em seus próprios projetos. Com ele, você pode acessar dados de treino, reagir a eventos em tempo real e consumir conteúdo público de perfis da comunidade — tudo com uma interface simples e tipada.
Ele foi construído para funcionar tanto no Node.js quanto em ambientes de borda (edge runtimes), com suporte total a TypeScript.
Funcionalidades
Dados de Treino
Acesse workouts, séries, repetições e histórico de exercícios de usuários autenticados com permissão.
Webhooks & Eventos
Receba eventos em tempo real como início e conclusão de treinos, metas batidas e atualizações de perfil.
Posts & Conteúdo Público
Consuma posts, conquistas e conteúdo em destaque de perfis públicos da plataforma.
Dados de Treino
Com o SDK você consegue acessar o histórico de treinos de um usuário, listar os exercícios realizados, verificar séries e cargas, e acompanhar a evolução ao longo do tempo. Os dados são retornados em estruturas tipadas e prontas para uso.
O acesso a dados privados exige autenticação e consentimento explícito do usuário via fluxo OAuth — garante que apenas apps autorizados consigam ler as informações.
Webhooks & Eventos em Tempo Real
Registre endpoints para receber notificações automáticas quando algo acontece na plataforma. O SDK abstraí a validação de assinatura e o parsing dos payloads, então você só precisa reagir ao evento.
Eventos disponíveis (previstos)
Posts & Conteúdo Público
Perfis públicos do Vtrack podem ter seus posts e conquistas acessados sem autenticação. Com o SDK você pode buscar conteúdo em destaque, listar posts de um atleta ou trazer os eventos mais relevantes da comunidade para o seu app.
Esse recurso é ideal para integrações com sites de atletas, aplicativos de acompanhamento de equipes ou qualquer produto que queira exibir a atividade pública de usuários do Vtrack.
Quer acompanhar o desenvolvimento?
O SDK ainda está sendo construído e adoraríamos ouvir o que você precisa. Entre em contato com o time de desenvolvimento e deixe seu feedback — sua ideia pode entrar na próxima versão.
Falar com o time de devs