Cómo Empezar

Esta guía te mostrará los pasos necesarios para autenticarte y realizar tu primera consulta a la API pública de Kinoia.

Paso 1: Generar tu API Key

Para comenzar a realizar solicitudes, necesitas una clave de desarrollador activa.

Ingresa al Dashboard de Administración de Kinoia.
Haz clic en la sección Desarrolladores (icono de terminal en el menú lateral).
Haz clic en GENERAR CLAVE.
Escribe un nombre descriptivo (ej: Integración CRM) y selecciona los permisos (scopes) requeridos:
- contacts:read: Permite listar contactos y consultar sus etiquetas.
- conversations:read: Permite leer chats e historial de mensajes.
Presiona Generar Clave.

Guardado Seguro Obligatorio

Por razones de seguridad, la clave se mostrará en texto plano solo una vez. Copia el token de inmediato antes de cerrar la ventana y guárdalo en tus variables de entorno seguras (.env).

Paso 2: Configurar las Cabeceras de Solicitud

Todas las peticiones a la API deben incluir la clave en la cabecera X-API-Key.

X-API-Key: kinoia_live_your_api_key_here

Paso 3: Realizar tu Primera Petición

Para comprobar tu conexión, realiza una consulta al endpoint de contactos desde tu backend o usando cURL.

curl -H "X-API-Key: kinoia_live_tu_api_key" \
  "http://localhost:9000/api/v1/public/contacts"

Si todo está configurado correctamente, recibirás una respuesta 200 OK con la lista de contactos en formato JSON.

Limitaciones de Seguridad (CORS)

Recuerda que la API de Kinoia bloquea peticiones provenientes del navegador (CORS). Todas las integraciones deben realizarse Server-to-Server. Si intentas realizar la llamada desde tu código frontend (React/Vue/Angular/HTML), el API Gateway responderá con un código de estado 403 Forbidden.