Referencia de la API

La API de Eclectic te permite gestionar mensajes, plantillas, contactos, conversaciones, agentes y datos de búsqueda, además de recibir eventos webhook en tiempo real. Las solicitudes se realizan sobre HTTPS y se autentican con una API key.

Contacta al equipo antes de usar la API

Antes de empezar a usar la API debes contactar al equipo de Eclectic para habilitar tu acceso y obtener tu token. Escríbenos para coordinar la integración.

URL base

Todas las solicitudes a la API se realizan sobre la siguiente URL base. Cada endpoint de esta referencia es relativo a ella.

http
https://api.eclecticlabs.com/api/external/v2

Autorización

Autentica cada solicitud enviando tu API key en la cabecera X-API-Key.

http
X-API-Key: ek_live_your_api_key_here
Content-Type: application/json

Formato y cabeceras

La API acepta y devuelve JSON. Envía siempre la cabecera Content-Type: application/json en las solicitudes con cuerpo.

Límites de uso

Las solicitudes tienen un límite de uso por token de API. Si superas el límite recibirás una respuesta 429 y deberás reintentar tras una breve espera.

Errores

Los errores se devuelven con el código de estado HTTP correspondiente y un cuerpo JSON que describe el problema.

json
{
  "errors": [
    {
      "code": "unauthorized",
      "message": "Invalid or missing API token"
    }
  ]
}