Что вы сделаете
- Выпустите 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-подписями. События отдельных кликов пока недоступны; полный список - в руководстве по вебхукам.