Ce vei face
- Emite o cheie API cu scopuri definite din Settings → API keys — token-ul este afișat o singură dată, așa că trebuie copiat imediat.
- Scurtează un link cu un singur apel SDK sau o singură comandă
curlîn mai puțin de un minut. - Folosește chei de idempotență la cererile care modifică date, astfel încât reîncercările să nu creeze niciodată linkuri duplicate.
API-ul Elido este REST + JSON, documentat cu OpenAPI 3.1 și limitat ca rată per cheie. Oferim SDK-uri proprii pentru TypeScript, Go și Python care îl încapsulează. Serverul MCP din @elido/mcp-server expune aceeași suprafață agenților AI.
Emite o cheie API
- Settings → API keys → Create key.
- Alege un nume (recomandăm sistemul care o va folosi:
zapier,internal-billing,marketing-cli). - Alege scopurile. Cele patru comune:
links:read— listează și inspectează linkuri.links:write— creează, actualizează, șterge linkuri.analytics:read— interoghează evenimentele de click.webhooks:write— gestionează abonamentele la webhook-uri.
- Apasă Create. Cheia este afișată o singură dată — noi stocăm doar un hash.
Dacă pierzi o cheie, revoc-o de pe aceeași pagină și emite una nouă. Cheile revocate sunt respinse în 60 de secunde în toate regiunile.
Ghid rapid cu SDK-ul TypeScript
import { ElidoClient } from "@elido/sdk";
const client = new ElidoClient({ apiKey: process.env.ELIDO_API_KEY! });
const link = await client.links.create({
destination: "https://acme.com/spring-sale",
slug: "spring-2026",
});
console.log(link.short_url);
SDK-urile Go și Python urmează aceeași structură. Referința completă la /api.
Ghid rapid cu curl
curl -X POST https://api.elido.app/v1/links \
-H "Authorization: Bearer $ELIDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"destination":"https://acme.com/spring-sale","slug":"spring-2026"}'
Limite de rată
Nivelul gratuit primește 60 de cereri pe minut per cheie. Pro: 600/min. Business: 6000/min. Burst-ul este de 2× limita de regim constant; headerul de răspuns X-RateLimit-Remaining îți arată unde te afli.
Dacă atingi limita, API-ul returnează 429 cu Retry-After setat. SDK-urile implementează reîncercare cu backoff exponențial în mod implicit — dezactiveaz-o dacă aplicația ta gestionează propria politică de reîncercare.
Idempotență
Endpoint-urile care modifică date acceptă un header Idempotency-Key. Trimite un UUID pentru fiecare scriere intenționată; păstrăm răspunsul în cache timp de 24 de ore, astfel încât reîncercările (erori de rețea, timeout-uri ambigue) să nu creeze duplicate.
SDK-urile adaugă headerul automat. Dacă folosești curl direct, generează cheia pe partea client și include-o la fiecare reîncercare.
Webhook-uri
Pentru notificări în timp real în locul interogării periodice, configurează webhook-uri sub Settings → Webhooks — livrăm evenimentele link.created, link.clicked.aggregated și domain.verified cu semnături HMAC.