API y SDKs. Build on Elido, in any language.

Sí. La versión actual es v1, a la que se accede en /v1/... Los cambios importantes se anuncian en el registro de cambios con un periodo de depreciación de 90 días antes de que se elimine el comportamiento antiguo. Las adiciones que no rompan la compatibilidad (nuevos campos, nuevos parámetros opcionales) se envían sin aumentar la versión. La versión de la API es estable; si alguna vez se introduce la v2, la v1 funcionará en paralelo durante al menos 12 meses. La especificación OpenAPI en /openapi.json siempre refleja la versión estable actual.

Autenticación por token Bearer: incluye tu clave de API en el encabezado Authorization como 'Bearer elido_sk_...'. El valor de la clave se muestra solo una vez al crearla. Para las llamadas de webhook de servidor a servidor desde Elido a tu sistema, Elido firma el cuerpo de la solicitud con HMAC-SHA256 utilizando un secreto compartido; verifica el encabezado X-Elido-Signature en tu manejador de webhook. Las credenciales de cliente OAuth2 están disponibles para integraciones de socios donde la distribución de claves de API de espacio de trabajo no sea práctica; contáctanos para el registro de socios OAuth2.

Sí. El SDK de TypeScript utiliza la API fetch (disponible en todos los entornos edge modernos) y evita las APIs exclusivas de Node.js (sin fs, sin http, sin Buffer). Está probado en Cloudflare Workers, Vercel Edge Functions y Deno Deploy. Si estás ejecutando el SDK en un entorno edge restringido, utiliza la ruta de importación ligera (@elido/sdk/edge) que excluye las utilidades de CLI y los módulos exclusivos de Node.js del bundle.

Para Claude: añade el servidor MCP a tu claude_desktop_config.json con tu clave de API como una variable de entorno; los documentos del MCP de Elido tienen un bloque de configuración para copiar y pegar. Para ChatGPT (llamada a funciones): el servidor MCP expone un manifiesto de herramientas JSON Schema en /.well-known/mcp.json que puedes importar en la configuración de acciones de tu GPT. Para Cursor: añade el servidor MCP como una herramienta local en los ajustes de Cursor con npx @elido/mcp-server. Todas las configuraciones requieren una clave de API de Elido válida con los ámbitos correspondientes.

Todos los endpoints de lista utilizan paginación basada en cursor. La respuesta incluye un campo next_cursor (nulo si no hay más páginas). Pasa el valor del cursor como el parámetro de consulta cursor en la siguiente solicitud. El tamaño de página por defecto es 50; el máximo es 200. La paginación basada en cursor es estable: añadir o eliminar registros entre páginas no causa que los elementos se omitan o se repitan, a diferencia de la paginación basada en desplazamiento. Los SDKs incluyen un ayudante de autopaginación que entrega los elementos de uno en uno independientemente de los límites de página.

Sí. Las claves de API tienen alcance de espacio de trabajo, pero puedes tener claves para múltiples espacios de trabajo. El prefijo del endpoint de la API es /v1/workspaces/{workspace_id}/...; pasa el ID del espacio de trabajo del objetivo. Si estás construyendo una herramienta de gestión de múltiples espacios de trabajo (por ejemplo, un portal de agencia que gestiona espacios de trabajo de clientes), tendrás una clave de API por espacio de trabajo. Las credenciales de socio OAuth2 con alcance para múltiples espacios de trabajo están disponibles para integraciones de plataforma; contacta con ventas.

Plan gratuito: 60 solicitudes por minuto por espacio de trabajo. El límite de velocidad se aplica en el gateway de la API con un algoritmo de cubo de tokens (token bucket). Cuando el cubo está vacío, la API devuelve HTTP 429 con un encabezado Retry-After indicando cuándo estará disponible el próximo token. Los SDKs respetan automáticamente el Retry-After en las respuestas 429. Ten en cuenta que los endpoints masivos tienen límites separados: el endpoint de creación masiva de enlaces cuenta como una solicitud independientemente de cuántos enlaces haya en el cuerpo.

Sí: pasa el encabezado X-Elido-Sandbox: true a cualquier solicitud de API para ejecutarla contra el entorno sandbox. Las solicitudes de sandbox crean objetos reales en una partición de espacio de trabajo de sandbox (enlaces, campañas, etc.), pero el tráfico de redirección no se sirve desde el edge de producción. Usa el sandbox para pruebas de integración y pipelines de CI/CD. Los objetos de sandbox no cuentan contra las cuotas de enlaces o clics de tu plan. El sandbox se reinicia cada 24 horas; no dependas de los datos del sandbox para uso en producción.