​
Autenticación de la API

Para acceder a los recursos de Laburen a través de la API, necesitarás autenticarte utilizando una clave de API (API Key). Esta página explica cómo obtener y utilizar tu clave de API correctamente.

​
Obtener tu Clave de API

Sigue estos pasos para obtener tu clave de API:

  1. Inicia sesión en tu Dashboard de Laburen
  2. Navega a Configuración > Claves de API
  3. Haz clic en “Crear Nueva Clave de API”
  4. Proporciona un nombre descriptivo para tu clave (por ejemplo, “Integración con mi sitio web”)
  5. Selecciona los permisos necesarios para tu caso de uso
  6. Haz clic en “Crear”
  7. ¡Importante! Copia y guarda tu clave de API en un lugar seguro. No podrás verla nuevamente después de cerrar esta pantalla.

​
Usar tu Clave de API

Para autenticar tus solicitudes a la API de Laburen, debes incluir tu clave de API en el encabezado Authorization de tus solicitudes HTTP:

'Authorization': 'Bearer TU_CLAVE_DE_API'

​
Ejemplo con cURL

curl -X POST \
  https://api.laburen.com/api/agents/tu-id-de-agente/query \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer TU_CLAVE_DE_API' \
  -d '{
    "query": "¿Cuáles son sus horarios de atención?"
  }'

​
Ejemplo con JavaScript

const response = await fetch('https://api.laburen.com/api/agents/tu-id-de-agente/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer TU_CLAVE_DE_API'
  },
  body: JSON.stringify({
    query: '¿Cuáles son sus horarios de atención?'
  })
});

const data = await response.json();
console.log(data);

​
Ejemplo con Python

import requests

url = "https://api.laburen.com/api/agents/tu-id-de-agente/query"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer TU_CLAVE_DE_API"
}
payload = {
    "query": "¿Cuáles son sus horarios de atención?"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

​
Seguridad de las Claves de API

Para mantener tus claves de API seguras:

  • No compartas tus claves de API en repositorios públicos o código cliente
  • Utiliza variables de entorno para almacenar tus claves de API en tus aplicaciones
  • Asigna permisos mínimos a cada clave de API que crees
  • Rota tus claves periódicamente para minimizar el riesgo en caso de exposición
  • Revoca inmediatamente cualquier clave que pueda haber sido comprometida

Si necesitas integrar la API de Laburen en código del lado del cliente (como JavaScript en un navegador), considera crear un endpoint proxy en tu servidor para proteger tu clave de API.

​
Solución de Problemas

Si recibes errores de autenticación (código 401 o 403), verifica:

  • Que estás utilizando la clave de API correcta
  • Que la clave no ha sido revocada o ha expirado
  • Que estás incluyendo el prefijo Bearer antes de la clave
  • Que la clave tiene los permisos necesarios para el recurso al que intentas acceder

Para más ayuda, contacta a nuestro equipo de soporte en support@laburen.com.