Referencia de la API

La API de Eclectic te permite enviar mensajes, consultar el estado de entrega y recibir eventos webhook en tiempo real. Las solicitudes se realizan sobre HTTPS y se autentican con un token bearer.

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.try-eclectic.com/v1

Autorización

Autentica cada solicitud enviando tu token de API como token bearer en la cabecera Authorization.

http
Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM
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"
    }
  ]
}