KBIA Volver al inicio

Integradores

API pública de preguntas

Autenticación machine-to-machine con API key por cuenta. Pensada para bots, IVR y canales de chat. La clave de acceso la entrega EasySoft Solutions al activar la cuenta.

Autenticación

API key

Formato kbia_<prefix>_<secret>. Envía la key completa en uno de estos headers: 

Authorization: Bearer kbia_<prefix>_<secret>
X-Api-Key: kbia_<prefix>_<secret>
  • La key identifica la cuenta. No envíes tenantId en el body para autenticarte.
  • Guarda el secret en un lugar seguro; no lo compartas ni lo registres en logs.
  • Si una key se filtra, solicita rotación o revocación a EasySoft.

Endpoint

Preguntar a la knowledge base

POST /ai/api/v1/KnowledgeBase/ask

Base URL de producción: https://kbia.easysoftsolutions.com.co

Body (JSON)

{
  "question": "¿Cuál es el horario de atención?",
  "sessionId": "opcional-para-contexto"
}

Ejemplo curl

curl -sS -X POST \
  "https://kbia.easysoftsolutions.com.co/ai/api/v1/KnowledgeBase/ask" \
  -H "Authorization: Bearer kbia_XXXXXXXX_…" \
  -H "Content-Type: application/json" \
  -d '{"question":"¿Cuál es el horario?","sessionId":"opcional"}'

Respuestas

Códigos de error frecuentes

Respuestas habituales cuando la solicitud no puede completarse.

HTTP Significado
401

API key ausente o inválida.

403

Cuenta inactiva o key sin permiso para ask.

429

Límite de solicitudes excedido; reintenta más tarde.

400

Solicitud inválida (p. ej. pregunta vacía o demasiado larga).

Si las políticas de seguridad de la cuenta bloquean la pregunta o la respuesta, la API devuelve el mensaje configurado para ese caso (no es un fallo de autenticación).

Soporte

¿Necesitas una API key?

Contacta a EasySoft Solutions para activar tu cuenta y recibir las credenciales de integración.

EasySoft Solutions Volver al producto