API y widget

Integre la búsqueda con IA de LiKE en sus aplicaciones, sitio web o sistemas internos. Tres métodos de integración: REST API, widget JS, iframe.

#REST API

#Paso 1 — Crear una clave de API

1. Integraciones → Public API → «Crear clave»
2. Introduzca un nombre (por ejemplo, «Aplicación móvil»)
3. Copie la clave — se muestra solo una vez

#Paso 2 — Usar la API

Todas las solicitudes se autorizan mediante el encabezado:

X-API-Key: your-key

#Endpoints principales

#Ejemplo: búsqueda con IA

curl -X POST https://amedia.lynkora.pro/api/public/search \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Как оформить отпуск?"}'

Respuesta:

{
  "answer": "Для оформления отпуска...",
  "sources": [
    {"title": "Политика отпусков", "url": "..."}
  ]
}

#Límites de frecuencia

Las solicitudes de API se limitan por clave. El límite concreto depende de su plan; cuando se supera, se devuelve HTTP 429 con un encabezado Retry-After. Los valores exactos de su plan están en la sección del plan.

#Seguridad

1. Almacene las claves en variables de entorno, no en el código
2. Cree una clave independiente para cada aplicación
3. Elimine las claves no utilizadas
4. Restrinja los dominios en la configuración de la clave

#Widget JS

Un botón flotante de búsqueda con IA para integrar en cualquier sitio web.

#Paso 1 — Obtener el código

1. Integraciones → JS Widget
2. Configure los parámetros (véase la tabla más abajo)
3. Copie el código

#Paso 2 — Añadirlo a su sitio

Inserte el <script> copiado antes de la etiqueta de cierre </body>:

#Parámetros del widget

#Resultado

Aparece un botón morado en la esquina de su sitio. Haga clic → una ventana modal con una barra de búsqueda → una respuesta de IA de su base de conocimientos.

#iframe

Una interfaz de búsqueda con todas las funciones integrada en su página:

#Código de integración

#Enlace directo

Si un iframe no le conviene, ofrezca a los usuarios un enlace directo: https://amedia.lynkora.pro

#Modo de demostración

Para probar sin una clave de API, hay disponible un endpoint de demostración con limitaciones:

Endpoint: POST /api/public/demo/search

#Comparación de modos de autenticación

El widget admite dos modos de autenticación.

#Modo A — Confiar en la zona de URL

Autenticación del lado del cliente: usted es responsable de quién llega a las páginas con el widget (VPN, SSO, rutas protegidas). Lynkora no conoce la identidad del usuario — solo el Origin/IP de la solicitud. El widget es visible para todos los que abran una página con el código de integración.

• Código de backend: 0 líneas
• Tiempo de puesta en marcha: ~2 minutos
• Adecuado para: intranet, portal interno

#Modo B — Token de sesión (JWT por usuario)

Su backend emite un token de sesión de corta duración para cada usuario. Lynkora conoce la identidad, mantiene una auditoría por usuario y admite la revocación y el DSAR del RGPD.

• Código de backend: ~10 líneas (mediante SDK)
• Tiempo de puesta en marcha: 1–2 horas
• Adecuado para: SaaS multiinquilino, sectores regulados