Uma API é uma forma de dois sistemas trocarem informações automaticamente, sem precisar de alguém clicando em telas. Pense nela como um "garçom": seu sistema faz um pedido (uma requisição), a API leva esse pedido até a cozinha (o sistema da Clínica Experts) e traz a resposta de volta.
Com a API da Clínica Experts, você pode conectar outras ferramentas (um CRM, uma planilha, um sistema de agendamento) ao ecossistema Clínica Experts, para que os dados circulem automaticamente entre eles.
Para que a API saiba que é você fazendo a requisição — e não qualquer pessoa — você usa uma chave de API (token). É como uma senha exclusiva para sistemas, em vez de pessoas.
Você encontra e gerencia suas chaves na página de Integrações, na aba de configuração.
<aside> 💡
❗ Atenção
</aside>
Essa chave dá acesso amplo à sua conta — é equivalente a uma senha. Por isso:
- Nunca cole sua chave em repositórios públicos (GitHub, etc.)
- Nunca deixe sua chave visível em código que roda no navegador do usuário (client-side)
- Se suspeitar que ela foi exposta, gere uma nova e revogue a antiga
Toda vez que um sistema faz uma requisição à API, ele precisa "se apresentar" enviando a chave de API dentro de um header — um campo de informação extra que acompanha a requisição, além do conteúdo principal (pense nele como o remetente escrito no envelope de uma carta).
O header usado se chama Authorization, e o formato é sempre:
'Authorization': 'Bearer SUA_API_KEY'