Що ви зробите
- Випустіть API-ключ з обмеженими правами в Налаштування → API-ключі: токен показується лише один раз, тому скопіюйте його одразу.
- Скоротіть посилання одним викликом SDK або однією командою
curlменш ніж за хвилину. - Використовуйте ключі ідемпотентності в запитах, що змінюють дані, щоб повтори ніколи не створювали посилання вдруге.
API Elido - це REST + JSON із документацією OpenAPI 3.1 та обмеженням частоти запитів на кожен ключ. Ми постачаємо власні SDK для TypeScript, Go і Python, які його обгортають. MCP-сервер у @elido/mcp-server відкриває ту саму поверхню ШІ-агентам.
Випуск API-ключа
- Налаштування → API-ключі → Створити ключ.
- Виберіть ім'я (радимо називати за системою, яка його використовуватиме:
zapier,internal-billing,marketing-cli). - Виберіть права. Чотири найпоширеніші:
links:read- перелік і перегляд посилань.links:write- створення, зміна та видалення посилань.analytics:read- запити до подій кліків.webhooks:write- керування підписками на вебхуки.
- Натисніть Створити. Ключ показується один раз: ми зберігаємо лише його хеш.
Якщо ви втратили ключ, відкличте його на тій самій сторінці й випустіть новий. Відкликані ключі відхиляються протягом 60 секунд у всіх регіонах.
Швидкий старт із TypeScript SDK
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 для Go і Python влаштовані так само. Повний довідник - у /api.
Швидкий старт із 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"}'
Обмеження частоти запитів
Безкоштовний тариф отримує 60 запитів на хвилину на ключ. Pro: 600/хв. Business: 6000/хв. Сплеск допускається до 2× від сталого ліміту; заголовок відповіді X-RateLimit-Remaining показує, скільки залишилось.
Якщо ви впираєтеся в ліміт, API повертає 429 із заголовком Retry-After. SDK за замовчуванням повторюють запит з експоненційною затримкою: вимкніть це, якщо ваш застосунок використовує власну політику повторів.
Ідемпотентність
Ендпоінти, що змінюють дані, приймають заголовок Idempotency-Key. Передавайте UUID на кожен задуманий запис; ми кешуємо відповідь на 24 години, щоб повтори (мережеві помилки, неоднозначні тайм-аути) не створювали дублікатів.
SDK додають цей заголовок автоматично. Якщо ви використовуєте curl напряму, згенеруйте ключ на боці клієнта й передавайте його під час кожного повтору.
Вебхуки
Для сповіщень у реальному часі замість опитування налаштуйте вебхуки в Налаштування → Вебхуки: ми доставляємо події, як-от link.created, link.updated та domain.verified, з HMAC-підписами. Події окремих кліків поки недоступні; повний перелік - у посібнику з вебхуків.