API & SDKs. Construiește pe Elido, în orice limbaj.
API REST complet, SDK-uri TypeScript, Go și Python, plus un server MCP pentru fluxuri de lucru cu agenți AI. Limitele de rată se scalează cu planul; cheile API sunt limitate la workspace, cu seturi granulare de permisiuni.
- SDK-uri TypeScript, Go și Python - toate open-source
- Specificație OpenAPI 3.1 cu documentație interactivă
- Server MCP pentru Claude și fluxuri de lucru cu agenți AI
- Chei API per scop, cu limite de rată în funcție de plan
SDK-uri oficiale
Patru SDK-uri. O singură suprafață de API.
Fiecare SDK este generat din aceeași specificație OpenAPI 3.1 - când API-ul este lansat, SDK-urile se actualizează în aceeași zi. Tipurile TypeScript, interfețele Go și dataclass-urile Python rămân sincronizate automat.
Obiecte de cerere/răspuns tipizate. Funcționează în Node.js, Cloudflare Workers, Vercel Edge și Deno.
npm install @elido/sdkGo idiomatic, cu propagare de context și hot paths cu zero alocări, pentru servicii cu trafic ridicat.
go get github.com/elidoapp/elido-goClienți sincroni și asincroni (asyncio). Tipizați cu modele Pydantic v2. Disponibil pe PyPI.
pip install elido-sdkServer Model Context Protocol - conectează gestionarea linkurilor Elido la Claude, ChatGPT, Cursor și orice agent AI compatibil MCP.
npx @elido/mcp-serverReferință API
OpenAPI 3.1. Interactivă. Mereu actuală.
Specificația OpenAPI de la /openapi.json este sursa de adevăr pentru fiecare endpoint, parametru și structură de răspuns. Tipurile SDK sunt generate din ea - fără decalaj, fără stub-uri întreținute manual.
- Specificație descărcabilă/openapi.json - JSON citibil automat
- Referință interactivăApeluri autentificate din browser
- Colecție PostmanGenerată automat din specificația OpenAPI
- Generarea SDK-urilorTipuri construite din specificație la fiecare lansare
- Depreciere de 90 de zileSchimbările incompatibile sunt semnalate din timp
- POST
/v1/linksCreează un link scurt - GET
/v1/links/{id}Obține un link după ID - PATCH
/v1/links/{id}Actualizează destinația sau metadatele linkului - DELETE
/v1/links/{id}Arhivează sau șterge un link - GET
/v1/linksListează linkuri (paginare pe cursor) - POST
/v1/bulk/linksCreează în masă până la 500 de linkuri
X-RateLimit-Remaining
X-RateLimit-Reset
Limite de rată
Limite care se scalează cu planul tău.
Limitare de rată token-bucket per workspace, per cheie API. Alocațiile de burst îți permit un vârf de 10x pentru până la 5 secunde - astfel încât un job de creare în masă a linkurilor, la începutul unei campanii, nu se blochează niciodată.
- Header-e X-RateLimit-Limit / Remaining / Reset la fiecare răspuns
- SDK-ul reîncearcă automat, cu backoff exponențial, la 429
- Endpoint-urile bulk au limite separate, mai mari
- Chei per scop - cheile analytics doar-citire nu consumă cota de scriere
- Limite personalizate pentru volume de lucru enterprise ridicate - contactează echipa de vânzări
Ce poți face
- API REST cu specificație OpenAPI 3.1
- SDK-uri TypeScript, Go și Python
- Server MCP pentru Claude, ChatGPT, Cursor
- Chei API limitate la workspace, cu permisiuni per scop
- Webhook-uri pentru livrarea asincronă a evenimentelor
- API intern gRPC (edge → core)
Ce oferă stack-ul API Elido dezvoltatorilor
O specificație OpenAPI și câteva SDK-uri sunt minimul necesar. Capacitățile de mai jos acoperă detaliile care contează atunci când construiești integrări de producție.
Specificație OpenAPI 3.1, colecție Postman și referință interactivă - fiecare endpoint documentat cu exemple
Fiecare endpoint al API-ului Elido este documentat în specificația OpenAPI 3.1, disponibilă la /docs/api-reference și ca fișier JSON descărcabil la /openapi.json. Specificația este sursa unică de adevăr - tipurile SDK sunt generate din ea, astfel încât nu există decalaj între referință și SDK. Referința API interactivă îți permite să faci apeluri autentificate către workspace-ul tău direct din browser (lipești cheia API, alegi workspace-ul, apelezi endpoint-ul). O colecție Postman este generată automat din specificația OpenAPI și legată din pagina de documentație a fiecărui endpoint. Changelog-ul API-ului este versionat alături de changelog-ul principal - schimbările incompatibile primesc o notificare de depreciere de 90 de zile, cu un ghid de migrare, înainte de eliminare.
SDK-uri TypeScript, Go și Python - generate din specificația OpenAPI, actualizate la fiecare lansare de API
SDK-ul TypeScript (@elido/sdk) este publicat pe npm și acoperă întreaga suprafață a API-ului, cu obiecte de cerere și răspuns tipizate. Suportă atât Node.js, cât și runtime-uri edge (Cloudflare Workers, Vercel Edge, Deno). SDK-ul Go (github.com/elidoapp/elido-go) este Go idiomatic, cu propagare de context și hot paths cu zero alocări, pentru utilizare la trafic ridicat. SDK-ul Python (elido-python, disponibil pe PyPI) include atât clienți sincroni, cât și asincroni (asyncio). SDK-ul Ruby (gem-ul elido pe RubyGems) livrează Ruby idiomatic, cu HTTP sincron și tipuri de eroare compatibile cu ActiveRecord. Toate cele patru SDK-uri sunt generate din aceeași specificație OpenAPI, folosind un generator personalizat - actualizările sunt livrate în aceeași zi cu lansarea API-ului. Dacă limbajul tău nu este acoperit, specificația OpenAPI este cea mai rapidă cale de a construi un client.
Chei API de workspace cu permisiuni per scop - chei separate pentru analitice doar-citire vs gestionarea linkurilor vs admin
Cheile API sunt limitate la workspace (nu la utilizator) și includ un set de permisiuni definit la momentul creării cheii. Scopuri: links:read, links:write, links:delete, analytics:read, campaigns:read, campaigns:write, webhooks:manage, domains:manage, workspace:admin. Integrările de analitice doar-citire ar trebui să folosească o cheie cu doar analytics:read. Pipeline-urile CI/CD care creează linkuri ar trebui să folosească links:write. Operațiunile de admin necesită workspace:admin. Cheile pot fi rotite individual, fără a revoca alte chei - rotația generează o nouă valoare de cheie, iar valoarea veche este invalidată imediat. Cheile sunt afișate o singură dată, la creare; Elido stochează un HMAC al cheii, nu textul simplu. Pentru echipele provizionate prin SCIM, cheile de cont de serviciu sunt recomandate în locul cheilor API personale, pentru integrări de producție.
Server MCP Elido: conectează gestionarea linkurilor la Claude, ChatGPT, Cursor și orice agent AI compatibil MCP
Serverul MCP Elido (@elido/mcp-server, publicat pe npm) implementează Model Context Protocol și expune gestionarea linkurilor Elido ca instrumente apelabile de agenți AI. Instrumente suportate: create_link, get_link, update_link, list_links, get_analytics, create_campaign, list_campaigns. Serverul MCP se autentifică cu o cheie API de workspace și limitează accesul instrumentelor la permisiunile cheii. Conectează-l în bucla de utilizare a instrumentelor din Claude, în ChatGPT Plugins (function calling), în contextul AI al Cursor, sau în orice runtime compatibil MCP. Exemplu de utilizare: un asistent AI care primește un brief în limbaj natural („creează cinci linkuri pentru această lansare de produs, unul per canal, cu UTM-uri din șablonul campaniei Q2-launch”) și apelează create_link de cinci ori, cu parametrii corecți derivați din brief. Serverul MCP poate fi self-hosted sau rulat ca binar npx pentru dezvoltare locală.
Limite de rată pe plan - Free 60/min, Pro 300/min, Business 1.000/min - plus alocații de burst
Limitele de rată ale API-ului se aplică per workspace, per cheie API: Free 60 de cereri/minut, Pro 300/minut, Business 1.000/minut. Alocațiile de burst îți permit să depășești limita pentru până la 5 secunde (10x limita de rată), înainte ca limitarea strictă să intre în vigoare. Header-ele de limită de rată sunt incluse în fiecare răspuns: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (marcă de timp Unix). SDK-urile includ reîncercare automată cu backoff exponențial la răspunsuri 429 - nu trebuie să implementezi asta tu. Pentru operațiuni în masă (creare de linkuri, export de analitice), preferă endpoint-urile bulk (POST /bulk, exporturi programate) în locul apelurilor API per element - endpoint-urile bulk au limite separate, mai mari. Dacă cazul tău de utilizare necesită un debit susținut peste limitele Business (de ex., un redirector self-hosted de mare volum care apelează API-ul Elido pentru popularea cache-ului), contactează echipa de vânzări pentru o limită personalizată.
Echipe de dezvoltatori care construiesc pe API-ul Elido
Numele sunt substituenți - studiile de caz reale ale clienților vor apărea aici pe măsură ce sunt publicate.
“Tipurile SDK-ului TypeScript sunt generate din specificația OpenAPI - când Elido lansează o nouă versiune de API, actualizăm versiunea pachetului, iar TypeScript ne spune imediat dacă integrarea noastră folosește un câmp depreciat. Fără erori surpriză la runtime.”
“Am conectat serverul MCP Elido la Claude, pentru a permite echipei noastre de conținut să creeze și să etichetăm linkuri de campanie dintr-o interfață de chat. Configurarea a durat 20 de minute. Echipa de conținut creează acum cu 40% mai puține tichete de suport către inginerie pentru sarcini de gestionare a linkurilor.”
“SDK-ul Go, cu propagare de context, se integrează direct în service mesh-ul nostru. Creăm linkuri scurte pentru paginile de urmărire a expedierilor server-side, chiar la momentul creării expedierii - SDK-ul gestionează transparent reîncercările și backoff-ul pentru limita de rată.”
API & SDK-uri Elido vs API Bitly vs API Rebrandly
Toate trei au API-uri REST. Diferențele sunt în calitatea SDK-urilor, limitele de rată, disponibilitatea specificației OpenAPI și suportul pentru MCP/agenți AI.
| Feature | Elido | Bitly API | Rebrandly API |
|---|---|---|---|
| Specificație OpenAPI / Swagger | OpenAPI 3.1 - descărcabilă, sursă de adevăr pentru SDK-uri | Specificație Swagger disponibilă | Specificație OpenAPI disponibilă |
| SDK-uri oficiale | TypeScript, Go, Python - generate din specificație | SDK-uri oficiale JavaScript și Python | Doar SDK JavaScript |
| Limită de rată (Business) | 1.000 de cereri/min, cu burst | Plan enterprise: variază în funcție de contract | 500 de cereri/min (Business) |
| Server MCP pentru agenți AI | Da - @elido/mcp-server pe npm | Indisponibil | Indisponibil |
| Permisiuni de cheie API per scop | Da - 9 scopuri, atribuire per cheie | Doar doar-citire vs citire-scriere | Control limitat al scopului |
| Livrare webhook | Semnate HMAC-SHA256, reîncercare automată, mod SIEM | Indisponibil | Indisponibil |
| API intern gRPC | Da - de la edge la core, apeluri interne cu latență redusă | Doar REST | Doar REST |
Întrebări despre API & SDK
API-ul este versionat? Cum funcționează schimbările incompatibile?
Da. Versiunea curentă este v1, accesată la /v1/... Schimbările incompatibile sunt anunțate în changelog, cu o fereastră de depreciere de 90 de zile, înainte ca vechiul comportament să fie eliminat. Adăugările compatibile (câmpuri noi, parametri opționali noi) sunt lansate fără o schimbare de versiune. Versiunea API-ului este stabilă; dacă v2 va fi vreodată introdusă, v1 va rula în paralel timp de cel puțin 12 luni. Specificația OpenAPI de la /openapi.json reflectă mereu versiunea stabilă curentă.
Ce metodă de autentificare folosește API-ul?
Autentificare prin token Bearer: include cheia ta API în header-ul Authorization, ca „Bearer elido_sk_...”. Valoarea cheii este afișată o singură dată, la creare. Pentru apelurile de webhook server-to-server de la Elido către sistemul tău, Elido semnează corpul cererii cu HMAC-SHA256, folosind un secret partajat - verifică header-ul X-Elido-Signature în handler-ul tău de webhook. Credențialele de client OAuth2 sunt disponibile pentru integrări de parteneri unde distribuirea cheilor API de workspace este impracticabilă - contactează-ne pentru onboarding-ul de parteneri OAuth2.
Funcționează SDK-ul TypeScript în Cloudflare Workers și runtime-uri edge?
Da. SDK-ul TypeScript folosește API-ul fetch (disponibil în toate runtime-urile edge moderne) și evită API-urile specifice Node.js (fără fs, fără http, fără Buffer). Este testat pe Cloudflare Workers, Vercel Edge Functions și Deno Deploy. Dacă rulezi SDK-ul într-un mediu edge cu restricții, folosește calea de import ușoară (@elido/sdk/edge), care exclude din bundle utilitarele CLI și modulele specifice Node.js.
Cum folosesc serverul MCP cu Claude sau ChatGPT?
Pentru Claude: adaugă serverul MCP în claude_desktop_config.json, cu cheia ta API ca variabilă de mediu - documentația MCP Elido are o configurație copy-paste, într-un singur bloc. Pentru ChatGPT (function calling): serverul MCP expune un manifest de instrumente JSON Schema la /.well-known/mcp.json, pe care îl poți importa în configurația de acțiuni a GPT-ului tău. Pentru Cursor: adaugă serverul MCP ca instrument local în setările Cursor, cu npx @elido/mcp-server. Toate configurațiile necesită o cheie API Elido validă, cu scopurile relevante.
Care este modelul de paginare pentru endpoint-urile de listare?
Toate endpoint-urile de listare folosesc paginare bazată pe cursor. Răspunsul include un câmp next_cursor (null dacă nu mai există pagini). Transmite valoarea cursorului ca parametru de query cursor la următoarea cerere. Dimensiunea implicită a paginii este 50; maximul este 200. Paginarea bazată pe cursor este stabilă - adăugarea sau ștergerea de înregistrări între pagini nu duce la omiterea sau repetarea elementelor, spre diferență de paginarea bazată pe offset. SDK-urile includ un helper de auto-paginare care produce elementele unul câte unul, indiferent de limitele paginilor.
Pot folosi API-ul pentru a gestiona mai multe workspace-uri dintr-un singur client?
Da. Cheile API sunt limitate la workspace, dar poți deține chei pentru mai multe workspace-uri. Prefixul endpoint-ului API este /v1/workspaces/{workspace_id}/... - transmite ID-ul workspace-ului țintă. Dacă construiești un instrument de gestionare multi-workspace (de ex., un portal de agenție care gestionează workspace-urile clienților), vei deține o cheie API per workspace. Credențiale de parteneri OAuth2 cu scop cross-workspace sunt disponibile pentru integrări de platformă - contactează echipa de vânzări.
Care este limita de rată pe planul gratuit și cum este aplicată?
Planul Free: 60 de cereri pe minut per workspace. Limita de rată este aplicată la nivelul API gateway-ului, cu un algoritm token bucket. Când bucket-ul este gol, API-ul returnează HTTP 429, cu un header Retry-After care indică momentul la care următorul token va fi disponibil. SDK-urile respectă automat Retry-After la răspunsurile 429. Reține că endpoint-urile bulk au limite separate - endpoint-ul de creare în masă a linkurilor contează ca o singură cerere, indiferent de câte linkuri sunt în payload.
Există un mediu sandbox sau de test?
Da - transmite header-ul X-Elido-Sandbox: true la orice cerere API pentru a o rula în mediul sandbox. Cererile sandbox creează obiecte reale într-o partiție de workspace sandbox (linkuri, campanii etc.), dar traficul de redirecționare nu este servit din edge-ul de producție. Folosește sandbox-ul pentru testarea integrărilor și pipeline-urile CI/CD. Obiectele sandbox nu contează în cotele de linkuri sau clicuri ale planului tău. Sandbox-ul se resetează la fiecare 24 de ore - nu te baza pe datele din sandbox pentru utilizare în producție.
Continuă lectura
Livrare de evenimente de ieșire semnate HMAC - complementul asincron al API-ului sincron.
Resursa API pe care o vei apela cel mai des - creează, actualizează și interoghează linkuri scurte programatic.
Interoghează evenimentele de clic și agregatele prin API-ul de analitice - aceleași date ca în dashboard-ul de analitice.
Pagina de soluție orientată către dezvoltatori - REST, SDK-uri, webhook-uri și o privire de ansamblu asupra experienței dezvoltatorului.
Ești pregătit să încerci?
Începe cu planul gratuit, fă upgrade când ai nevoie de un domeniu personalizat.