Autenticação
Todas as chamadas à API do Quantika Hub devem ser autenticadas. A autenticação é validada em cada requisição de forma atômica e multi-tenant.
Formatos Suportados
A API suporta três maneiras de autenticar suas requisições:
Recomendado1. Cabeçalho Authorization (Bearer Token)
Envie o seu Client Token no cabeçalho padrão HTTP Authorization:
cURL com Bearer Token
curl -X GET https://quantikahub.com/api/v1/account \
-H "Authorization: Bearer qk_live_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json"2. Cabeçalhos X-Client-Id e X-Client-Token
Você também pode enviar as duas chaves individualmente nos cabeçalhos customizados:
cURL com X-Client-Id
curl -X GET https://quantikahub.com/api/v1/account \
-H "X-Client-Id: cid_live_yyyyyyyyyyyyyyyy" \
-H "X-Client-Token: qk_live_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json"3. Query Parameter (?clientToken=...)
Útil para webhooks de ferramentas que não permitem configurar cabeçalhos customizados ou para conectar ao Servidor MCP:
https://quantikahub.com/api/v1/contacts?clientToken=qk_live_xxxxxxxx
Exemplos de Integração
JavaScript / TypeScript (Fetch)
const response = await fetch("https://quantikahub.com/api/v1/account", {
method: "GET",
headers: {
"Authorization": "Bearer qk_live_xxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
});
const data = await response.json();
console.log(data);Python (Requests)
import requests
url = "https://quantikahub.com/api/v1/account"
headers = {
"Authorization": "Bearer qk_live_xxxxxxxxxxxxxxxx",
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(response.json())Segurança das Credenciais
O seu Client Token concede acesso total de leitura e escrita às mensagens, contatos e negociações do seu CRM. Nunca o publique em repositórios abertos no GitHub, não o compartilhe em chats e nunca o armazene em código frontend acessível publicamente no navegador.