Co zrobisz
- Wygenerujesz klucz API z zakresami w Settings → API keys. Token jest pokazywany tylko raz, więc skopiuj go od razu.
- Skrócisz link jednym wywołaniem SDK lub pojedynczym poleceniem
curlw niecałą minutę. - Użyjesz kluczy idempotentności w żądaniach modyfikujących, aby ponowienia nigdy nie tworzyły zduplikowanych linków.
API Elido jest oparte na REST + JSON, udokumentowane w OpenAPI 3.1 i objęte limitami na klucz. Udostępniamy oficjalne SDK dla TypeScript, Go i Pythona, które je opakowują. Serwer MCP w @elido/mcp-server udostępnia ten sam interfejs agentom AI.
Wygeneruj klucz API
- Settings → API keys → Create key.
- Wybierz nazwę (zalecamy nazwę systemu, który będzie go używać:
zapier,internal-billing,marketing-cli). - Wybierz zakresy. Cztery najczęstsze:
links:read- wyświetlanie i podgląd linków.links:write- tworzenie, aktualizowanie i usuwanie linków.analytics:read- zapytania o zdarzenia kliknięć.webhooks:write- zarządzanie subskrypcjami webhooków.
- Kliknij Create. Klucz jest pokazywany tylko raz, ponieważ przechowujemy wyłącznie jego hash.
Jeśli zgubisz klucz, unieważnij go na tej samej stronie i wygeneruj nowy. Unieważnione klucze są odrzucane w ciągu 60 sekund we wszystkich regionach.
Szybki start z SDK 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 dla Go i Pythona mają taką samą strukturę. Pełna dokumentacja znajduje się pod adresem /api.
Szybki start z 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"}'
Limity zapytań
Plan darmowy ma 60 żądań na minutę na klucz. Pro: 600/min. Business: 6000/min. Burst wynosi 2× limitu ustalonego; nagłówek odpowiedzi X-RateLimit-Remaining informuje, ile jeszcze zostało.
Po przekroczeniu limitu API zwraca 429 z ustawionym Retry-After. SDK domyślnie ponawiają żądania z wykładniczym wycofywaniem (backoff). Wyłącz to, jeśli Twoja aplikacja ma własną politykę ponowień.
Idempotentność
Endpointy modyfikujące akceptują nagłówek Idempotency-Key. Przekaż UUID dla każdego zamierzonego zapisu; przechowujemy odpowiedź przez 24 godziny, dzięki czemu ponowienia (błędy sieci, niejednoznaczne timeouty) nie tworzą duplikatów.
SDK dodają ten nagłówek automatycznie. Jeśli używasz bezpośrednio curl, wygeneruj klucz po stronie klienta i dołączaj go do każdego ponowienia.
Webhooki
Aby otrzymywać powiadomienia w czasie rzeczywistym zamiast odpytywać API, skonfiguruj webhooki w Settings → Webhooks. Dostarczamy zdarzenia takie jak link.created, link.updated i domain.verified z podpisami HMAC. Zdarzenia dla pojedynczych kliknięć nie są jeszcze dostępne; pełną listę znajdziesz w przewodniku po webhookach.