A tecnologia está cada vez mais integrada ao dia a dia das academias, e a capacidade de conectar sistemas se tornou essencial para otimizar a gestão e melhorar a experiência dos alunos. Nesse contexto, as APIs desempenham um papel estratégico, pois permitem que diferentes aplicações conversem entre si de maneira padronizada e segura.


    Com a API da Tecnofit, sua academia ganha a possibilidade de ampliar o uso do sistema, integrando dados em tempo real com ferramentas externas. Isso significa automatizar processos, reduzir retrabalhos e garantir maior eficiência na operação, sempre com segurança e controle.


    Neste artigo, você vai entender como funciona a API da Tecnofit, quais são seus requisitos, endpoints disponíveis e o passo a passo para contratar e começar a usar esse recurso de integração no seu negócio.


Clique aqui para verificar a documentação técnica.



ÍNDICE



O que é uma API?


API é a sigla para Application Programming Interface, ou Interface de Programação de Aplicativos em português. O objetivo das APIs é permitir a comunicação e integração entre diferentes sistemas, facilitando o compartilhamento de dados em tempo real.


A Tecnofit disponibiliza uma API para que sistemas de terceiros possam consumir dados do sistema do cliente por meio de endpoints, que são pontos de acesso específicos dentro da API.



Como funciona a API da Tecnofit?


A arquitetura oferecida é RESTful, seguindo os princípios da arquitetura REST (Representational State Transfer). Isso significa que a comunicação entre sistemas é padronizada, simples e baseada em recursos.



Características e requisitos técnicos

  • Formato JSON: todas as requisições devem usar JSON, com cabeçalhos Content-Type e Accept definidos.
  • Limite de requisições: cada endpoint aceita até 100 requisições por minuto por IP e até 200 por minuto em nível global.
  • Segurança TLS 1.2+: obrigatório para todas as requisições.
  • Integração Multiempresa: em cenários de empresas com várias unidades, é necessário informar o identificador da unidade (X-Company-Id) no cabeçalho da requisição.



Recomendações

  • Realizar a integração em um ambiente seguro, evitando exposição de chaves.
  • Usar a API com responsabilidade, apenas para requisições necessárias.
  • Lembrar que as ações impactam diretamente no funcionamento real da academia.



Endpoints disponíveis


A API Tecnofit oferece uma série de endpoints que permitem acessar informações de diferentes áreas do sistema.


Unidades

  • Empresa Avulsa: gera um único ID, sem vínculo com outras unidades.
  • Empresa Multiempresa: se for matriz, retorna também os dados das unidades vinculadas.


Contratos

  • Contratos: lista todos os planos cadastrados.
  • Modalidades: associa os contratos a modalidades (exemplo: “Bem-Estar” → “Pilates” e “Yoga”).


Clientes

  • Clientes: obtém dados de alunos e prospects (campo type).
  • Endereço: lista endereços cadastrados.
  • Contatos: retorna todos os contatos registrados.
  • Contratos: apresenta todos os planos vinculados ao cliente.
  • Vendas: traz o histórico de vendas realizadas.


Funcionários

  • Funcionário: retorna informações de professores, recepcionistas, coordenadores etc.
  • Endereço: lista endereços cadastrados.
  • Contatos: retorna todos os contatos associados.


Produtos e financeiro

  • Produtos: retorna todos os produtos cadastrados na empresa.
  • Recebíveis: apresenta as contas a receber do sistema.



Como contratar a API


1. Acesse a opção "+Adicionais" e procure o item “API Aberta”:



2. Clique em "Solicitar contato do seu gerente de contas":



3. Seu gerente entrará em contato para alinhar responsabilidades e o que pode ser feito através da API.


4. Após finalizada a contratação, um novo menu chamado Integrações (API) será liberado no sistema.



Criando uma chave de integração


1. Acesse Gerencial > Configurações > Integrações (API):



2. Clique em "+Novo" e defina:

  • Nome: identificação da chave.
  • Permissões: sempre conceda o mínimo necessário.
OBS: Caso tenha o Multiempresa ativado, na matriz, você poderá escolher entre fazer uma integração avulsa (apenas na unidade que está logado) ou integração multiempresa (todas as unidades da rede).



3. Clique em "Cadastrar" ao final da página.


4. Após isso, você terá acesso as seguintes informações:

  • API_KEY (chave pública): usada para autenticação básica.
  • API_SECRET (chave privada): de uso restrito, não deve ser compartilhada.



⚠️ Importante: As chaves são exibidas apenas uma vez no momento da criação. Copie as chaves e cole no sistema de destino.



Editando chaves


1. Acesse Gerencial > Configurações > Integrações (API) e clique na integração desejada.


2. Alterne o status da API entre ativa e inativa:



⚠️ Chaves não utilizadas devem ser inativadas por segurança.



FAQ - Perguntas Frequentes


  • Preciso pagar para usar a API da Tecnofit?

Sim. (Incluir preço aqui após a definição).


  • E se eu perder a minha chave privada?

Será necessário inativar a chave anterior e gerar uma nova.


  • Onde posso integrar a API da Tecnofit?

A API pode ser integrada em todo e qualquer sistema que aceite integração no modelo RESTful com JSON, seguindo os requisitos técnicos informados na documentação.



Glossário


- API (Application Programming Interface): Conjunto de padrões e rotinas que permite a comunicação entre diferentes sistemas de software.
- Endpoint: Um endereço específico (URL) dentro da API, responsável por executar uma função ou fornecer dados.
- RESTful (Representational State Transfer): Estilo de arquitetura de software que define princípios para comunicação entre sistemas de forma simples e padronizada.
- JSON (JavaScript Object Notation): Formato leve e amplamente utilizado para troca de informações entre sistemas. É legível por humanos e fácil de interpretar por máquinas.
- Rate Limit (Limite de Requisições): Quantidade máxima de requisições que a API permite em um determinado período de tempo.
- TLS (Transport Layer Security): Protocolo de segurança que garante a proteção na transmissão de dados entre cliente e servidor. A versão mínima aceita pela API Tecnofit é a 1.2.
- Multiempresa: Estrutura usada em redes ou franquias, onde uma empresa matriz gerencia várias unidades vinculadas.



Ei! Queremos saber sua opinião. ✅ 


Deixe seu feedback ou comentário e nos ajude a melhorar. 


Vamos lá, sua opinião conta muito para nós! ❤️


Palavras-chave: API Tecnofit, integração Tecnofit, API aberta, endpoints Tecnofit, autenticação API, JSON Tecnofit, multiempresa Tecnofit