API REST y claves de API (integraciones)
Integra el CRM con otros sistemas mediante una API REST, autenticada por clave.
Sellio expone una API REST para que leas y escribas registros desde otros sistemas (Zapier, Make, tus propios scripts, etc.). El acceso se autentica con una clave de API que generas en Configuración → API y claves.
Generar una clave
- Ve a Configuración → API y claves.
- Dale un nombre (p. ej. "Integración Zapier") y haz clic en "Generar clave".
- Copia la clave AL INSTANTE: aparece una única vez y no se puede recuperar después.
- Para desactivar una integración, usa "Revocar": la clave deja de funcionar de inmediato.
Endpoints
- GET /api/v1/{objeto}: lista registros (parámetros: limit, offset, search).
- GET /api/v1/{objeto}/{id}: un registro.
- POST /api/v1/{objeto}: crea un registro (cuerpo JSON con los campos).
- PATCH /api/v1/{objeto}/{id}: actualiza campos de un registro.
Envía la clave en la cabecera Authorization: Bearer sk_live_… El {objeto} es el Nombre de API del objeto (contact, company, lead, opportunity o un objeto tuyo).
Rate limit y uso (SLA)
Cada clave tiene un límite de solicitudes por minuto (por defecto 120), ajustable en la propia lista de claves. Toda respuesta trae las cabeceras X-RateLimit-Limit (el tope), X-RateLimit-Remaining (cuántas caben aún en la ventana actual) y X-RateLimit-Reset (el instante, en epoch, en que la ventana se reinicia).
Al superar el límite, la API responde 429 (Too Many Requests) con la cabecera Retry-After indicando en cuántos segundos volver a intentar. La pantalla de claves también muestra el total de solicitudes ya hechas por cada clave (métrica de uso).