Autenticación

Referencia de autenticación para la API de ixblix.

Autenticación por Clave de API

Todos los endpoints en el ámbito de la empresa requieren el header X-API-Key:

X-API-Key: smci_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Obteniendo una Clave de API

Las claves de API se generan durante la activación de la empresa. Veja Registro de Empresa.

Autenticación de Integrador

Los endpoints en el ámbito del integrador usan HTTP Basic Auth con integratorId y accessToken:

curl https://api.ixblix.app/api/plans \
  -u "int_xxxx:ixblix_integrator_token_xxxx"

Autenticación del Contacto (Cliente)

Los endpoints para el cliente usan el token de la conversación (del deeplink) en lugar de una clave de API. No se necesita header de autenticación — el token se incluye en el cuerpo de la solicitud o en la URL.

Recomendaciones de Seguridad

• Almacene claves de API en un gestor de secretos seguro, nunca en el control de versiones.
• Rote claves si son expuestas.
• Use HTTPS para todas las solicitudes.
• La clave de API otorga acceso a todos los recursos de la empresa; trátela como una contraseña.

Errores de Autenticación