Developer API

Стройте на linkz.ge

Создавайте и управляйте ссылками из кода. REST API, JSON, Bearer-токен. Просто и быстро.

Получить API-ключ Возможности

REST + JSON

Один POST — короткая ссылка.

Безопасно

Личный Bearer-токен на аккаунт.

Квота

Месячный лимит по тарифу — виден в заголовках ответа.

curl -X POST https://linkz.ge/api/v1/shorten \
  -H "Authorization: Bearer lz_xxx" \
  -d '{"url":"https://example.com/page"}'

# → { "ok": true, "data": {
#     "short_url": "https://linkz.ge/abc123" } }

Пример использования

Представьте разработчика, чьему SaaS-продукту нужно автоматически генерировать короткие ссылки — например, реферальную ссылку для каждого нового пользователя. Он просто отправляет один POST-запрос к API linkz.ge с Bearer-токеном и мгновенно получает готовую короткую ссылку, которая автоматически вставляется в продукт — без ручной работы.

Часто задаваемые вопросы

Где найти документацию по API?

Эндпоинт — POST /api/v1/shorten с заголовком "Authorization: Bearer <api_key>" и JSON-телом. Обязателен url. alias, title и monetize работают на всех тарифах; на платных (Pro/Business) дополнительно доступны password, expires_at, url_mobile, og_title, og_description, og_image, ab_variants (A/B-ротация) и link_targets (гео/device-таргетинг). Ответ — JSON с ok и data либо error. Та же сводка доступна в /llms.txt.

Есть ли лимит запросов (rate limit)?

Да, есть месячная квота в зависимости от плана: Free — 200, Pro — 10 000, Business — 100 000 запросов в месяц. Каждый авторизованный ответ содержит заголовки X-RateLimit-Limit и X-RateLimit-Remaining, при превышении возвращается HTTP 429.

Можно ли иметь несколько Bearer-токенов?

Сейчас на аккаунт используется один активный токен — он виден на странице профиля. Если ключ утёк, свяжитесь с нами, и мы его заменим.

Смотрите также

A/B-ротация

Одна ссылка — несколько адресов

Гео- и device-таргетинг

Разные страницы для разных посетителей

Готовы начать?

Бесплатный аккаунт за секунды. Карта не нужна.

Получить API-ключ