← Выберите ракурс, который подходит вашей команде

Для разработчиков

Платформа ссылок с простым REST API.

Вы измеряете задержку, частоту ошибок и время до MTTR. Elido даёт вам REST + gRPC, SDK на четырёх языках (TypeScript, Go, Python, Ruby), спаны OpenTelemetry на каждом редиректе и self-hosting по договору (Enterprise), если SaaS - не та форма.

Начать бесплатно Читать спецификацию

REST + gRPC: выбирайте поверхность, которую предпочитает ваша сервисная сеть
Спаны OpenTelemetry для каждого редиректа и каждого API-вызова
Четыре SDK: TypeScript, Go, Python, Ruby
Self-hosting по договору (Enterprise)

POST /v1/links

201 Created · 38 ms

Request

curl -X POST https://api.elido.app/v1/links
  -H "Authorization: Bearer $ELIDO_API_KEY"
  -H "Idempotency-Key: ci-2026-05-08-build-4419"
  -d '{
    "destination_url": "https://shop.example.com/launch",
    "slug": "q2-launch",
    "workspace_id": "ws_8f3c"
  }'

Response

{
  "id": "link_01HQ3X...",
  "short_url": "https://b.elido.me/q2-launch",
  "click_tracker": "https://api.elido.app/v1/links/link_01HQ3X/clicks",
  "expires_at": "2026-08-08T00:00:00Z",
  "created_at": "2026-05-08T11:24:01Z"
}

Idempotent · safe to retry Live spec

OpenAPI 3.1

Формат спецификации

Собственные SDK

5 ms

p50 редиректа (cache HIT)

MCP

Официальный MCP-сервер

Наблюдаемость - встроенная, а не прикрученная

Каждый редирект генерирует спан OpenTelemetry. Каждый спан попадает в ваш коллектор.

Edge-сервис инструментирован сквозным образом с помощью OTel. Направьте свой OTLP-коллектор на уровень редиректа - и вы получите полный водопад: поиск в кеше, оценка правил, ответ и асинхронная публикация события клика - без написания ни одной строки инструментации самостоятельно.

Trace · 7f3a91 · GET / → 302

5 spans · 5.2 ms wall

edge.redirect

edge service · server

4.8 ms

cache.lookup (L1 → L2)

in-process LRU + hot cache

0.6 ms

rule.evaluate

smart-link first-match

0.3 ms

response.write

302 + click_id header

1.0 ms

click.publish (async)

event stream · fire-and-forget

0.4 ms

Wall time

5.2 ms

Cache

L1 hit

Exporter

OTLP/gRPC

Руководство по наблюдаемости →Edge-архитектура →

SDK

Один канонический вызов. Шесть языков. Все сгенерированы из одной спецификации.

Каждый SDK поставляется из одной и той же спецификации OpenAPI 3.1. Добавили новый эндпоинт на сервере? Запустите генератор, отгрузите SDK - готово. Никакого клиента с ручным обслуживанием, который расходится с API. Ключи идемпотентности, повторные попытки с экспоненциальным откатом и типизированные ответы на ошибки реализованы единообразно на всех шести языках.

Спецификация OpenAPI 3.1 как единый источник истины
Спецификация зафиксирована. SDK перегенерируются при каждом релизе.
Типизированные ответы на ошибки
Лимит скорости, валидация, конфликт - всё типизировано, без строкового перехвата.
Ключи идемпотентности
На основе заголовка для каждого эндпоинта записи, повторяется при повторной попытке.
Встроенные повторные попытки
Экспоненциальный откат с соблюдением Retry-After на каждом языке.

Все четыре SDK →

Canonical create - same call, three SDKs

generated from spec

TypeScriptcreate-link.ts

 1import { Elido } from 
 2  "@elido/sdk";
 3 
 4const elido = new Elido({
 5  apiKey: process.env.ELIDO_API_KEY!,
 6});
 7 
 8const link = await elido.links.create({
 9  destinationUrl: dest,
10  slug: "q2-launch",
11});

Gocreate-link.go

 1import "elido"
 2 
 3client := elido.NewClient(
 4  elido.WithAPIKey(key),
 5)
 6 
 7link, err := client.Links.Create(ctx,
 8  &elido.CreateLinkRequest{
 9    DestinationURL: dest,
10    Slug: "q2-launch",
11  })

Pythoncreate_link.py

 1from elido import Elido
 2 
 3elido = Elido(
 4  api_key=os.environ["ELIDO_API_KEY"],
 5)
 6 
 7link = elido.links.create(
 8  destination_url=dest,
 9  slug="q2-launch",
10  idempotency_key=build_id,
11)

[email protected] · [email protected] · [email protected] in sync

gRPC-контракт

Та же поверхность в protobuf - для нативных сервисных сетей.

Сервис api-core обслуживает и REST, и gRPC из одних и тех же обработчиков. Если ваша платформа нативно говорит proto (Envoy, Istio, Linkerd, Connect-Go) - пропустите JSON-уровень. Файлы .proto опубликованы; генерируйте клиенты на любом языке, который поддерживает buf или protoc.

link_service.proto

buf · v1

1syntax = "proto3";
2 
3package elido.api.v1;
4 
5option java_multiple_files = true;
6 
7service LinkService {
8  rpc Create(CreateLinkRequest) returns (Link);
9  rpc Resolve(ResolveLinkRequest) returns (ResolveLinkResponse);
10  rpc List(ListLinksRequest) returns (ListLinksResponse);
11  rpc Delete(DeleteLinkRequest) returns (google.protobuf.Empty);
12}
13 
14message CreateLinkRequest {
15  string workspace_id = 1;
16  string destination_url = 2;
17  optional string slug = 3;
18  optional google.protobuf.Timestamp expires_at = 4;
19  repeated KeyValue tags = 5;
20}
21 
22message Link {
23  string id = 1;
24  string short_url = 2;
25  string destination_url = 3;
26  google.protobuf.Timestamp created_at = 4;
27}

served from api-core:9090 stable

mTLSservice-mesh native

Authenticate with workload identity via SPIFFE/SPIRE or your mesh's built-in mTLS. API keys still work for non-mesh callers.

Same handlersREST and gRPC

One implementation in api-core. Connect-Go transcoding means the REST surface is generated, not separately maintained.

Streamingserver-side events

ResolveLinkResponse streams click events for hot links - useful for internal dashboards without webhook plumbing.

Справочник gRPC →

Что вы получаете из коробки

REST + gRPC: выбирайте поверхность, которую предпочитает ваша сервисная сеть
Спаны OpenTelemetry для каждого редиректа и каждого API-вызова
Четыре SDK: TypeScript, Go, Python, Ruby
Self-hosting по договору (Enterprise)
Вебхук-файрхоз с подписью HMAC-SHA256
Эндпоинт Prometheus /metrics на каждом сервисе

Что на самом деле предлагает API Elido

Спецификация OpenAPI и Bearer-токен - это лишь база. Описанные ниже возможности - это то, что отличает сервис коротких ссылок, на котором можно строить системы, от того, с которым придется бороться в 2 часа ночи.

Предсказуемый REST

OpenAPI 3.1 с 44 документированными эндпоинтами - никаких скрытых методов

Каждый эндпоинт в продакшене описан в спецификации OpenAPI 3.1. Никаких «теневых» маршрутов или недокументированных параметров, о которых забыла команда документации. Спецификация хранится в репозитории и версионируется вместе с API; любые критические изменения следуют SemVer и имеют период устаревания не менее 90 дней. Спецификация интерактивно отображается в документации через Scalar - просто вставьте свой API-ключ и тестируйте вызовы прямо в браузере. Три SDK (TypeScript, Python, Go) генерируются из этой же спецификации при каждом релизе, поэтому они не могут расходиться с тем, что фактически принимает сервер. Методы SDK принимают типизированные объекты запросов и возвращают типизированные ответы; ошибки типизированы, а не просто перехватываются как строки. Поддерживаются ключи идемпотентности для методов записи - передайте заголовок `Idempotency-Key`, и ответ будет воспроизведен при повторной попытке без создания дубликата.

Программное управление слагами

Детерминированные слаги, массовое создание и идемпотентность для CI-пайплайнов

POST /v1/workspaces/{ws}/links принимает поле slug - вы получаете именно тот слаг, который запросили, или ошибку конфликта с ID существующей ссылки, чтобы ваш пайплайн мог решить, что делать дальше. Массовое создание (POST .../links/bulk) принимает до 100 спецификаций ссылок за один вызов; ответ содержит по одному результату для каждой входной строки с созданной ссылкой или описанием ошибки, поэтому частичные сбои не остаются незамеченными. Оба эндпоинта поддерживают ключи идемпотентности: повторно отправьте тот же запрос с тем же ключом и получите тот же ответ без создания дубликатов. Это стандартный паттерн для CI/CD пайплайнов, создающих короткие ссылки при деплое - детерминировано, безопасно для повторных попыток и консистентно между средами. Пространство имен слагов привязано к собственному домену: один и тот же слаг на двух разных доменах - это две разные ссылки, а не конфликт.

Вебхуки и firehose

Вебхуки с подписью HMAC, автоматическими повторами и dead-letter queue

Каждое событие рабочего пространства (создание, клик, удаление ссылки, запись в аудите, атрибуция конверсии) доступно через вебхук. Данные подписываются с помощью HMAC-SHA256 с использованием ротируемого секрета; ключ подписи отделен от вашего API-ключа, поэтому ротация одного не аннулирует другой. Семантика доставки: at-least-once с экспоненциальной задержкой (1с, 5с, 30с, 5м, 30м) и настраиваемым окном повторов (по умолчанию 24ч). События, исчерпавшие попытки, попадают в dead-letter queue, видимую в дашборде; оттуда их можно воспроизвести повторно. Для высоконагруженных пайплайнов событий Kafka-совместимый firehose полностью обходит HTTP-доставку - потребляйте события кликов и логи аудита напрямую из стрима. Firehose доступен в тарифе Business; доставка вебхуков доступна в тарифе Pro и выше.

Протокол MCP

Сервер Model Context Protocol: инструменты Elido в любом MCP-клиенте

Сервер Elido MCP предоставляет эндпоинты ссылок, QR и аналитики как типизированные инструменты MCP. Установка занимает 30 секунд: добавьте блок сервера в конфигурацию Claude Desktop или Cursor, установите ELIDO_API_KEY и перезапустите. Каталог инструментов обнаруживается автоматически - никаких ручных определений, которые могут устареть. По умолчанию доступен только режим чтения; операции записи требуют явного разрешения в настройках рабочего пространства. Каждый вызов инструмента отображается в логе аудита с указанием вызывающего ключа и аргументов, поэтому изменения, внесенные агентами, всегда можно отследить. Сервер работает через stdio и SSE; он использует те же лимиты и коды ошибок, что и REST API, включая заголовок Retry-After при ошибке 429, чтобы ваш агент мог корректно снизить нагрузку. Сервер пока не опубликован публично: публичный релиз скоро; обратитесь в поддержку для раннего доступа.

Self-hosting

Self-hosting по договору (Enterprise)

Helm-чарт для Kubernetes есть в репозитории. Условия лицензии и поддерживаемая модель самостоятельного размещения определяются договором; свяжитесь с [email protected], прежде чем полагаться на самостоятельное размещение.

Используемый стек

TypeScript SDK
Python SDK
Go SDK
Поток вебхуков
Спецификация OpenAPI 3.1

Что вы будете измерять

p50 задержка перенаправления: 5 ms при попадании в кэш
SLA работоспособности API: 99.95% на Business

API Elido vs API Bitly vs разработка собственного сервиса

Два внешних варианта и альтернатива в виде собственной разработки. Честно о том, где API Bitly более зрелый, а где собственное решение дает больше контроля.

Возможность	Elido	API Bitly	Свой сервис
Формат спецификации API	OpenAPI 3.1, хранится в репозитории	Кастомная документация v4 (не OpenAPI)	Всё, что вы напишете
Собственные SDK	TypeScript, Python, Go - генерируются из спецификации	JavaScript, Python, Ruby и Java	Вы создаете их сами
Ключи идемпотентности для записи	Да - через заголовки, для всех эндпоинтов записи	Не задокументировано	Вы реализуете это сами
Массовое создание	100 за вызов, обработка частичных сбоев для каждой строки	Нативный эндпоинт для массового создания не описан	Ваша схема, ваши правила
Доставка вебхуков	Доставка не реже одного раза, HMAC-SHA256, DLQ	Доступно в тарифе Enterprise	Вы строите это сами
Сервер MCP	Официальный MCP-сервер, установка 30 сек	Недоступно	Вы строите это сами
Self-hosting	По договору (Enterprise)	Недоступно	Полный контроль, полная стоимость
p50 задержки редиректа	5 мс при попадании в кэш (HIT)	Сопоставимо (edge-served)	Зависит от вашей инфраструктуры

Вопросы разработчиков

Где найти спецификацию OpenAPI?

По адресу /docs/api-reference - Scalar отображает её интерактивно. Исходный YAML доступен в /openapi.yaml. Это та же спецификация, на основе которой генерируются SDK, а не отдельно поддерживаемый документ.

Как получить детерминированный слаг в CI?

Передайте `slug` в теле запроса. Если слаг уже занят другой ссылкой, API вернет 409 с ID конфликтующей ссылки. Если он занят той же ссылкой (идемпотентное создание), вернется существующая ссылка. Используйте заголовок Idempotency-Key для безопасности повторных попыток.

Есть ли self-host?

Как получать события кликов без поллинга?

Два варианта: вебхуки (HTTPS, подпись HMAC, доставка at-least-once) или Kafka-совместимый firehose (прямое потребление, тариф Business). Вебхуки подходят для аудита и алертинга; firehose - верное решение для высоконагруженных пайплайнов, где важны накладные расходы на HTTP-доставку.

Какой лимит запросов (rate limit)?

100 запр/сек стабильно, 200 кратковременно (burst) на один API-ключ, с ошибкой 429 и заголовком Retry-After. Эндпоинты записи считаются отдельно от чтения. Сервер MCP передает 429 ошибку как ошибку инструмента; SDK предоставляют значение Retry-After как типизированное поле в ошибке лимита.

Можно ли использовать сервер MCP для автоматизации в продакшене, а не только интерактивно?

Да, сервер MCP - это стандартный процесс stdio или SSE. Его можно вызывать из скрипта, шага CI или пайплайна агентов. По умолчанию доступно только чтение; для записи требуется явная настройка рабочего пространства. Каждый вызов логируется.

Какова политика внесения критических изменений (breaking changes)?

Мы используем SemVer в префиксе версии API (/v1/, /v2/). Для критических изменений предусмотрено 90-дневное окно устаревания, когда обе версии доступны одновременно. Не критические дополнения (новые поля, эндпоинты) происходят без смены версии. Чейнджлог по адресу /changelog фиксирует каждое изменение.

Есть ли локальный режим разработки без обращения к реальному API?

SDK для TypeScript и Python позволяют переопределить baseUrl. Официального мок-сервера пока нет; для локального тестирования рекомендуется использовать тестовое рабочее пространство с отдельным API-ключом, а не мок. Это есть в планах развития.

Чтение для разработчика

API и SDK

Спецификация OpenAPI 3.1, четыре собственных SDK и что входит в каждый.

Вебхуки

HMAC-подписанные события, политика повторных попыток, очередь мёртвых писем, Kafka-файрхоз.

Умные ссылки

Движок правил на границе - полезен, когда логика маршрутизации не должна находиться в вашем сервисе.

Документация

Руководства, справочники и заметки по архитектуре - написаны командой, которая отгружает код.

Справочник API

Интерактивная спецификация OpenAPI, отрендеренная Scalar, все 44 эндпоинта.

Интеграции

Slack, Zapier, Make, n8n и другие.

Не уверены, какой ракурс подходит?

Большинство команд начинают с одного и развиваются до всех четырех. Наша команда продаж может обсудить ваш конкретный стек за 20 минут.

Начать бесплатно Связаться с отделом продаж