Elido
Центр помощи
API и SDK

Ключи API и быстрое начало работы с SDK

Создайте свой первый ключ Elido API, настройте правильные области действия и сократите ссылку из командной строки.

2 мин чтенияОбновлено 2026-05-15

Что вы сделаете

  • Выпустите ключ API с заданными областями действия в Settings → API keys — токен отображается только один раз, скопируйте его сразу.
  • Сократите ссылку одним вызовом SDK или единственной командой curl менее чем за минуту.
  • Будете использовать ключи идемпотентности в изменяющих запросах, чтобы повторные попытки никогда не создавали ссылки дважды.

Elido API является REST + JSON, документирован по OpenAPI 3.1 и имеет ограничения скорости на ключ. Мы поставляем собственные SDK для TypeScript, Go и Python, которые его оборачивают. Сервер MCP в @elido/mcp-server предоставляет тот же интерфейс для ИИ-агентов.

Выпуск ключа API#

  1. Настройки → Ключи API → Создать ключ.
  2. Выберите имя (рекомендуем указать систему, которая будет его использовать: zapier, internal-billing, marketing-cli).
  3. Выберите области действия. Четыре наиболее распространенные:
    • links:read — просматривать и проверять ссылки.
    • links:write — создавать, обновлять, удалять ссылки.
    • analytics:read — запрашивать события кликов.
    • webhooks:write — управлять подписками на вебхуки.
  4. Нажмите Создать. Ключ отображается один раз — мы храним только хеш.

Если вы потеряете ключ, отзовите его на той же странице и выпустите новый. Отозванные ключи отклоняются в течение 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 часа, чтобы повторные попытки (сетевые ошибки, неоднозначные тайм-ауты) не приводили к двойному созданию.

SDKs автоматически добавляют этот заголовок. Если вы используете curl напрямую, сгенерируйте ключ на стороне клиента и включайте его при каждой повторной попытке.

Вебхуки#

Для получения уведомлений в реальном времени вместо опроса настройте вебхуки в разделе Настройки → Вебхуки — мы доставляем события link.created, link.clicked.aggregated и domain.verified с HMAC подписями.

Это было полезно?
Нужно больше? Напишите команде - ответ в течение одного рабочего дня.Связаться с поддержкой