Pular para o conteúdo principal
Programadores

Chaves API

Crie uma chave para o seu próprio software e envie-a com cada pedido à API da HANC.

Uma chave API permite que o seu próprio software use a API da HANC: listar chamadas, criar agentes, comprar números, ler o seu CRM. Uma chave atua com o seu acesso — o que pode fazer no painel, ela pode fazer através da API.

Criar uma chave​

  1. Abra as chaves

    Integrações → o separador Programadores → Chaves API do espaço.

  2. Crie uma

    Clique em Criar token de API. A chave aparece na lista; o botão de mostrar revela-a e pode copiá-la a partir daí.

  • Até 3 chaves por workspace.
  • As chaves não têm nome nem permissões próprias: uma chave tem o seu acesso em todos os workspaces de que faz parte.
  • Uma chave pode ser mostrada de novo a partir da lista — trate a lista como informação sensível.

Como usar​

Envie a chave no cabeçalho x-api-key, sem o prefixo Bearer:

curl "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

Todos os endpoints estão descritos na Referência da API.

Mantenha-a segura​

  • Guarde as chaves no seu servidor — nunca num navegador, numa aplicação móvel ou em algo que um utilizador possa abrir.
  • Nunca as coloque no controlo de versões.
  • Substitua-as de vez em quando; elimine uma chave de imediato quando alguém sair ou se ela possa ter sido divulgada.
Nesta página