Saltar al contenido principal
Desarrolladores

Claves API

Crea una clave para tu propio software y envíala con cada solicitud a la API de HANC.

Una clave API permite que tu propio software use la API de HANC: listar llamadas, crear agentes, comprar números, leer tu CRM. Una clave actúa con tu acceso: lo que puedes hacer en el panel, ella puede hacerlo a través de la API.

Crear una clave​

  1. Abre las claves

    Integraciones → la pestaña Desarrolladores → Claves API del espacio.

  2. Crea una

    Haz clic en Crear un token API. La clave aparece en la lista; el botón de mostrar la revela y puedes copiarla desde ahí.

  • Hasta 3 claves por espacio de trabajo.
  • Las claves no tienen nombre ni permisos propios: una clave tiene tu acceso en todos los espacios de trabajo a los que perteneces.
  • Una clave se puede volver a mostrar desde la lista, así que trata la lista como información sensible.

Cómo usarla​

Envía la clave en el encabezado x-api-key, sin el prefijo Bearer:

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

Todos los endpoints se describen en la Referencia de la API.

Mantenla segura​

  • Guarda las claves en tu servidor, nunca en un navegador, en una aplicación móvil ni en nada que un usuario pueda abrir.
  • No las subas nunca al control de versiones.
  • Cámbialas de vez en cuando; elimina una clave de inmediato cuando alguien se vaya o si puede haberse filtrado.
En esta página