Quantika API Docs
v1.0 (Public API)

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.