API e SDK. Build on Elido, in any language.

Sì. La versione attuale è v1, accessibile su /v1/... Le modifiche drastiche vengono annunciate nel changelog con una finestra di deprecazione di 90 giorni prima della rimozione del vecchio comportamento. Le aggiunte non drastiche (nuovi campi, nuovi parametri opzionali) vengono rilasciate senza incrementare la versione. La versione dell'API è stabile; se mai venisse introdotta la v2, la v1 continuerà a funzionare in parallelo per almeno 12 mesi. La specifica OpenAPI su /openapi.json riflette sempre la versione stabile attuale.

Autenticazione con Bearer token: includi la tua chiave API nell'header Authorization come 'Bearer elido_sk_...'. Il valore della chiave viene mostrato una sola volta al momento della creazione. Per le chiamate webhook da server a server da Elido al tuo sistema, Elido firma il corpo della richiesta con HMAC-SHA256 utilizzando un segreto condiviso — verifica l'header X-Elido-Signature sul tuo gestore di webhook. Le credenziali client OAuth2 sono disponibili per le integrazioni partner in cui la distribuzione delle chiavi API dell'area di lavoro non è pratica — contattaci per l'onboarding partner OAuth2.

Sì. L'SDK TypeScript utilizza l'API fetch (disponibile in tutti i moderni runtime edge) ed evita le API solo per Node.js (niente fs, niente http, niente Buffer). È testato su Cloudflare Workers, Vercel Edge Functions e Deno Deploy. Se esegui l'SDK in un ambiente edge limitato, usa il percorso di importazione leggero (@elido/sdk/edge) che esclude le utilità CLI e i moduli solo per Node.js dal bundle.

Per Claude: aggiungi il server MCP al tuo file claude_desktop_config.json con la tua chiave API come variabile d'ambiente — la documentazione del server MCP di Elido ha un blocco di configurazione da copiare e incollare. Per ChatGPT (function calling): il server MCP espone un manifesto degli strumenti JSON Schema su /.well-known/mcp.json che puoi importare nella configurazione delle azioni del tuo GPT. Per Cursor: aggiungi il server MCP come strumento locale nelle impostazioni di Cursor con npx @elido/mcp-server. Tutte le configurazioni richiedono una chiave API di Elido valida con gli ambiti pertinenti.

Tutti gli endpoint di elenco utilizzano la paginazione basata su cursore. La risposta include un campo next_cursor (null se non ci sono più pagine). Passa il valore del cursore come parametro di query cursor nella richiesta successiva. La dimensione predefinita della pagina è 50; il massimo è 200. La paginazione basata su cursore è stabile — l'aggiunta o l'eliminazione di record tra le pagine non causa il salto o la ripetizione degli elementi, a differenza della paginazione basata sull'offset. Gli SDK includono un helper per l'auto-paginazione che restituisce gli elementi uno alla volta, indipendentemente dai confini della pagina.

Sì. Le chiavi API sono limitate all'area di lavoro, ma puoi possedere chiavi per più aree di lavoro. Il prefisso dell'endpoint API è /v1/workspaces/{workspace_id}/... — passa l'ID dell'area di lavoro di destinazione. Se stai creando uno strumento di gestione multi-area di lavoro (ad es., un portale di agenzia che gestisce le aree di lavoro dei clienti), avrai una chiave API per area di lavoro. Le credenziali partner OAuth2 con ambito multi-area di lavoro sono disponibili per le integrazioni di piattaforma — contatta l'ufficio vendite.

Piano gratuito: 60 richieste al minuto per area di lavoro. Il limite di velocità viene applicato al gateway API con un algoritmo token bucket. Quando il bucket è vuoto, l'API restituisce HTTP 429 con un header Retry-After che indica quando sarà disponibile il prossimo token. Gli SDK rispettano automaticamente Retry-After sulle risposte 429. Nota che gli endpoint bulk hanno limiti separati — l'endpoint di creazione massiva dei link conta come una singola richiesta, indipendentemente da quanti link ci siano nel payload.

Sì — passa l'header X-Elido-Sandbox: true a qualsiasi richiesta API per eseguirla nell'ambiente sandbox. Le richieste sandbox creano oggetti reali in una partizione dell'area di lavoro sandbox (link, campagne, ecc.) ma il traffico di reindirizzamento non viene servito dall'edge di produzione. Usa la sandbox per i test di integrazione e le pipeline CI/CD. Gli oggetti sandbox non contano ai fini delle quote di link o clic del tuo piano. La sandbox si resetta ogni 24 ore — non fare affidamento sui dati della sandbox per l'uso in produzione.