Создать ссылку через API

Отправьте POST на /links с Bearer-ключом и JSON с обязательным полем url. Скопируйте готовый запрос ниже и замените YOUR_API_KEY на свой ключ.

Открыть в кабинете

Запрос и ответ

POST

/links

Создать короткую ссылку

Один обязательный параметр — целевой url. Название, описание, customCode и domain необязательны.

UTM-метки передаются в query целевого url, отдельных UTM-полей в API нет.
Публичный адрес: https://{domain}/s/{shortCode}. Если clientPrefix заполнен, используйте https://{domain}/{clientPrefix}/{shortCode}.

Запрос cURL

curl -sS https://kratk.ru/api/links \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/product?utm_source=email&utm_medium=newsletter","title":"Товар"}'

Пример ответа 200

{
  "id": "9b4f...",
  "url": "https://example.com/product?utm_source=email&utm_medium=newsletter",
  "shortCode": "promo42",
  "domain": "kratk.ru",
  "hasPassword": false,
  "clientPrefix": null,
  "clickCount": 0
}

Дополнительные поля

title и description — необязательное название и описание.
customCode — свой slug вместо автоматического.
domain — домен короткой ссылки, если аккаунту доступен выбор.
tags — массив тегов; срок действия, мобильный URL и другие поля соответствуют модели создания ссылки.

UTM-метки — часть url. Отдельных UTM-полей в API нет. Для подготовки адреса можно использовать UTM Builder.

Как собрать публичный URL

Обычно это https://domain/s/shortCode. Если в ответе clientPrefix не равен null, используйте https://domain/clientPrefix/shortCode. В пакетном сценарии готовый shortUrl уже приходит в каждой успешной строке.

Связанные материалы

Не нашли ответ?

Напишите в поддержку — ответим в Telegram.

Открыть Telegram