REST API

Создание ссылок и чтение статистики из своих скриптов. Токен выпускается в кабинете: Настройки → API-токены.

Основа

https://urlshort.157.180.46.41.nip.io/api/v1

Авторизация — заголовком Authorization: Bearer usk_…. Формат — JSON в UTF-8. Ограничение запросов зависит от тарифа и передаётся в заголовках X-RateLimit-*.

Методы

Метод	Путь	Назначение
POST	/v1/links	Создать ссылку
GET	/v1/links	Список ссылок с фильтрами
GET	/v1/links/{id}	Получить ссылку
PATCH	/v1/links/{id}	Изменить, в том числе целевой адрес
DELETE	/v1/links/{id}	Удалить
GET	/v1/links/{id}/analytics	Статистика по ссылке
GET	/v1/analytics	Сводная статистика пространства
GET	/v1/me	Текущий токен, тариф и лимиты

Пример: создать ссылку

curl -X POST https://urlshort.157.180.46.41.nip.io/api/v1/links \
  -H "Authorization: Bearer usk_a1b2c3…" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://example.ru/promo",
    "code": "august",
    "title": "Августовская акция",
    "tags": ["промо", "вк"],
    "utm": {"utm_source": "vk", "utm_medium": "cpc"}
  }'

Ответ

{
  "id": 142,
  "code": "august",
  "short_url": "https://urlshort.157.180.46.41.nip.io/august",
  "target_url": "https://example.ru/promo",
  "qr_url": "https://urlshort.157.180.46.41.nip.io/qr/august",
  "clicks_total": 0,
  "created_at": "2026-08-07T12:00:00Z"
}

Модуль API в разработке. Схема и адреса методов зафиксированы, реализация появится в ближайшем обновлении. Токены уже можно выпускать.